Hacer un panel de ajustes para un tema

Publicado por Fernando Tellado el 9 Jul, 2008

Índice de contenidos

1 1 – Creando el fichero functions.php
2 2 – Creando la función de inicialización
3 3 – Creando la función que obtiene/guarda los datos
4 4 – Creando el formulario y la cabecera
5 5 – Editando tu archivo index.php (o el que quieras) Aquí es donde sucede la magia

Tomando la base del theme Mimbo, uno de los mas populares themes gratuitos de estilo revista, vamos a ver como configurarlo para que tenga un panel de opciones desde el que configurar varias personalizaciones sin tener que tocar el código a posteriori.

Aunque se toma como ejemplo la estructura de Mimbo se puede aplicar, y trasladar a cualquier theme de tu elección.

1 – Creando el fichero functions.php

Busca en la carpeta de tu theme el archivo ‘functions.php‘, y si no estuviera créalo para poder empezar esta tarea. Lo creas en blanco para incluir el código del siguiente paso.

2 – Creando la función de inicialización

La siguiente función, que incluiremos en el fichero ‘functions.php‘ inicializa todas las variables en caso de que no exista un valor definido (se ejecuta primero en el panel de opciones)

function mimic_init() {
// add_option('variable name','default value'
// Categoría a mostrar en el menú superior //
add_option('mimic_menu_cat', '1,2,3');
// Categoría de destacados//
add_option('mimic_featured_cat', 0);
}

function mimic_init() {

// add_option('variable name','default value'

// Categoría a mostrar en el menú superior //

add_option('mimic_menu_cat', '1,2,3');

// Categoría de destacados//

add_option('mimic_featured_cat', 0);

}

3 – Creando la función que obtiene/guarda los datos

Aquí se establecen las variables con los datos guardados y donde deben guardarse…

function mimic_add_theme_page()
{
// si las variables están vacías llamamos a la función mimic_init para establecer los valores por defecto
if((get_option('mimic_featured_cat') == ")||(get_option('mimic_menu_cat') == "))
	{mimic_init();}
if ($_GET['page'] == basename(__FILE__)) {
	//si el formulario se envia guardamos los cambios
	if ( 'save' == $_REQUEST['action'] )
	{
		//—–
		if(isset($_REQUEST['mimic_featured_cat']))
			{update_option('mimic_featured_cat', $_REQUEST['mimic_featured_cat']);}
		else
			{update_option('mimic_featured_cat', 'Fill this field please');}
		if(isset($_REQUEST['mimic_menu_cat']))
			{update_option('mimic_menu_cat', $_REQUEST['mimic_menu_cat']);}
		else
			{update_option('mimic_menu_cat', 'Fill this field please');}
		header("Location: themes.php?page=functions.php&saved=true");die;
	}
// Agrega la cabecera (css + script) al panel de opciones
add_action('admin_head', 'mimic_theme_page_head');}
//add_menu_page(page_title, menu_title, access_level/capability,file,[function]);
add_theme_page('Opciones del tema', 'Opciones del tema', 'edit_themes', basename(__FILE__), 'mimic_theme_page');
}

function mimic_add_theme_page()

{

// si las variables están vacías llamamos a la función mimic_init para establecer los valores por defecto

if((get_option('mimic_featured_cat') == ")||(get_option('mimic_menu_cat') == "))

{mimic_init();}

if ($_GET['page'] == basename(__FILE__)) {

//si el formulario se envia guardamos los cambios

if ( 'save' == $_REQUEST['action'] )

{

//—–

if(isset($_REQUEST['mimic_featured_cat']))

{update_option('mimic_featured_cat', $_REQUEST['mimic_featured_cat']);}

else

{update_option('mimic_featured_cat', 'Fill this field please');}

if(isset($_REQUEST['mimic_menu_cat']))

{update_option('mimic_menu_cat', $_REQUEST['mimic_menu_cat']);}

else

{update_option('mimic_menu_cat', 'Fill this field please');}

header("Location: themes.php?page=functions.php&saved=true");die;

}

// Agrega la cabecera (css + script) al panel de opciones

add_action('admin_head', 'mimic_theme_page_head');}

//add_menu_page(page_title, menu_title, access_level/capability,file,[function]);

add_theme_page('Opciones del tema', 'Opciones del tema', 'edit_themes', basename(__FILE__), 'mimic_theme_page');

}

4 – Creando el formulario y la cabecera

Aquí diseñamos el formulario …

Código para el formulario

function mimic_theme_page()
{
	if ( $_REQUEST['saved'] ) echo '</pre>
<div id="”message”" class="updated"><strong>Options Saved</strong></div>
<pre>
’;
?></pre>
<div class="wrap">
<div id="mimic">
<h2>Opciones del tema</h2>
<form action=""<?php" method="post" name="mimic">”> <input name="action" type="hidden" value="save" />
<table class="optiontable">
<tbody>
<tr>
<th>IDs de categoría del <em>menú de navegación</em>:</th>
<td><input id="2mimic_menu_cat" class="code" name="mimic_menu_cat" type="text" value="<?php />" /></td>
</tr>
<tr>
<th>ID de la categoría de destacados :</th>
<td><input id="mimic_featured_cat" class="code" name="mimic_featured_cat" type="text" value="<?php" />" /></td>
</tr>
</tbody>
</table>
<input name="Guardar" type="submit" value="Aplicar" /></form></div>
</div>
<pre>
< ?php }?

function mimic_theme_page()

{

if ( $_REQUEST['saved'] ) echo '</pre>

<div id="”message”" class="updated"><strong>Options Saved</strong></div>

<pre>

’;

?></pre>

<h2>Opciones del tema</h2>

<tbody>

<tr>

<th>IDs de categoría del <em>menú de navegación</em>:</th>

</tr>

<tr>

<th>ID de la categoría de destacados :</th>

</tr>

</tbody>

</table>

</div>

<pre>

< ?php }?

Esta función crea el formulario para entrar los valores personalizados

Código para la Cabecera

function mimic_theme_page_head()
{   // header Css+Script …?>< ?php}

1 2	function mimic_theme_page_head() { // header Css+Script …?>< ?php}

Ya casi hemos terminado, ahora solo queda una cosa por hacer, tenemos que conseguir los valores Guardados en nuestro theme.

5 – Editando tu archivo index.php (o el que quieras)
Aquí es donde sucede la magia

Simplemente añade este pequeño código en tu fichero index.php

El siguiente código es específico para el theme mimbo pero también otros themes usan la misma función para mostrar posts, así que puedes adaptarlo a tu propio theme.

En mimbo este código sirve para mostrar el último post de la categoría de destacados.

remplázalo por este otro código

remplaza también esta línea

por

y eso es todo, ahora puedes gestionar tu theme desde el panel de administración.

Gracias a CatsWhoCode.

AVISO: esta publicación es de hace dos años o más. Si es un código o un plugin podría no funcionar en las últimas versiones de WordPress, y si es una noticia podría estar ya obsoleta. Luego no digas que no te hemos avisado.