So, we have this code:

 
 
// Load up the localization file if we're using WordPress in a different language
// Place it in this plugin's folder and name it "MainFunction-[value in wp-config].mo"
load_plugin_textdomain( 'MainFunction', '/wp-content/plugins/MainFunction' );
 
/**
 * Content of Dashboard-Widget
 */
function MainFunction() {
	echo 'Test Add Dashboard-Widget';
}
 
/**
 * add Dashboard Widget via function wp_add_dashboard_widget()
 */
function MainFunction_Init() {
	wp_add_dashboard_widget( 'MainFunction', __( 'MainFunction Widget Title' ), 'MainFunction' );
}
 
/**
 * use hook, to integrate new widget
 */
add_action('wp_dashboard_setup', 'MainFunction_Init');
 

OK, now, remenber the wp_add_dashboard_widget function?

function wp_add_dashboard_widget( $widget_id, $widget_name, $callback, $control_callback = null )

The $control_callback parameter (obviously optional) is our main target. It gives the 'Configure' option to our spiffy widget.
So, we need to add a 4th parameter to wp_add_dashboard_widget:

wp_add_dashboard_widget( 'MainFunction', __( 'MainFunction Widget Title' ), 'MainFunction', 'MainFunction_Setup');

The MainFunction_Setup function handles two things: the options (set the default options, recolect new values, etc) and the option's presentation (i.e. the HTML part)

So, here goes the code:

 
 
function MainFunction_Options() {
	$defaults = array( 'items' => 5, 'boolean' => 1);
	if ( ( !$options = get_option( 'MainFunction' ) ) || !is_array($options) )
		$options = array();
	return array_merge( $defaults, $options );
}
 
function MainFunction_Setup() {
 
	$options = MainFunction_Options();
 
	if ( 'post' == strtolower($_SERVER['REQUEST_METHOD']) && isset( $_POST['widget_id'] ) && 'MainFunction' == $_POST['widget_id'] ) {
		foreach ( array( 'items', 'boolean' ) as $key )
				$options[$key] = $_POST[$key];
		update_option( 'MainFunction', $options );
	}
 
?>
 
 
		<label for="items"><PHP _e('How many items?', 'MainFunction' ); ?>
<select id="items" name="items">
				<PHP
					for ( $i = 5; $i <= 20; $i = $i + 1 )
						echo "
<option value='$i'" . ( $options['items'] == $i ? " selected='selected'" : '' ) . ">$i</option>
 
";
				?>
			</select>
 
		</label>
 
 
 
		<label for="boolean">
<input id="boolean" name="boolean" type="checkbox" value="1"<PHP if ( 1 == $options['boolean'] ) echo ' checked="checked"'; ?> />
			<PHP _e('Activate boolean?', 'MainFunction' ); ?>
		</label>
 
 
<PHP
 }
 

As you can see, MainFunction_Options puts the default values (if necessary, of course) and MainFunction_Setup show the current values and let change them. You can merge this two, of course...

Now, we have to get the options and use them in our MainFunction function. Change MainFunction like that:

 
/**
 * Content of Dashboard-Widget
 */
function MainFunction() {
 
        $widget_options = MainFunction_Options();
 
	echo 'Test Add Dashboard-Widget';
	echo "You have selected $widget_options['items'] items";
	echo "boolean is $widget_options['boolean']";
 
}
 

The complete code here:

 
<PHP
 
// Load up the localization file if we're using WordPress in a different language
// Place it in this plugin's folder and name it "MainFunction-[value in wp-config].mo"
load_plugin_textdomain( 'MainFunction', '/wp-content/plugins/MainFunction' );
 
/**
 * Content of Dashboard-Widget
 */
function MainFunction() {
        $widget_options = MainFunction_Options();
 
	echo 'Test Add Dashboard-Widget';
	echo "You have selected $widget_options['items'] items";
	echo "boolean is $widget_options['boolean']";
}
 
/**
 * add Dashboard Widget via function wp_add_dashboard_widget()
 */
function MainFunction_Init() {
	wp_add_dashboard_widget( 'MainFunction', __( 'MainFunction Widget Title' ), 'MainFunction' , 'MainFunction_Setup' );
}
 
function MainFunction_Options() {
	$defaults = array( 'items' => 5, 'boolean' => 1);
	if ( ( !$options = get_option( 'MainFunction' ) ) || !is_array($options) )
		$options = array();
	return array_merge( $defaults, $options );
}
 
function MainFunction_Setup() {
 
	$options = MainFunction_Options();
 
	if ( 'post' == strtolower($_SERVER['REQUEST_METHOD']) && isset( $_POST['widget_id'] ) && 'MainFunction' == $_POST['widget_id'] ) {
		foreach ( array( 'items', 'boolean' ) as $key )
				$options[$key] = $_POST[$key];
		update_option( 'MainFunction', $options );
	}
 
?>
 
 
		<label for="items"><PHP _e('How many items?', 'MainFunction' ); ?>
<select id="items" name="items">
				<PHP
					for ( $i = 5; $i <= 20; $i = $i + 1 )
						echo "
<option value='$i'" . ( $options['items'] == $i ? " selected='selected'" : '' ) . ">$i</option>
 
";
				?>
			</select>
 
		</label>
 
 
 
		<label for="boolean">
<input id="boolean" name="boolean" type="checkbox" value="1"<PHP if ( 1 == $options['boolean'] ) echo ' checked="checked"'; ?> />
			<PHP _e('Activate boolean?', 'MainFunction' ); ?>
		</label>
 
 
<PHP
 }
 
/**
 * use hook, to integrate new widget
 */
add_action('wp_dashboard_setup', 'MainFunction_Init');
 
?>
 

You can view a PHPS version (without PHP crippled tags) here.

© Rick's HideOut, 2009. | Permalink | Categorí­a: English, Wordpress | Tags: dashboard, widgets

Gracias a Maya, acabo de recibir mi paquetito con merchandising de WordPress.

Habrá que repartirlo por ahí. Por ejemplo, en la próxima TwittVigo

© Rick's HideOut, 2009. | Permalink | Categorí­a: Web2.0, Wordpress | Tags: schwag

(Nº ONCE) MOD (Nº Comentarios Post Sorteo) + 1 = Nº Comentario Ganador

Así, al basarte en un numero aleatorio externo, te evitas problemas.

Lo cual nos lleva a tener que numerar los comentarios de todos las entradas o, al menos, de las entradas que pertenezcan a una determinada categoría (Sorteos, por poner un ejemplo original).
La teoría es muy fácil (bueno, y la práctica también, la verdad). Solo hay que editar la plantilla de los comentarios de nuestro tema (normalmente comments.php) añadiendo un contador (que inicializaremos a 1 antes de entrar en el bucle de comentarios) y luego ir aumentándolo según nuestras condiciones.
Por ejemplo, yo numero todas los comentarios, pero en las entradas que pertenecen a la categoría Sorteos, los comentarios que hago yo no cuentan (para que el sistema no le asigne un número)
la cosa sería tal que así:

 
 
   if (in_category(321) && $comment->user_id != 1) { echo "#" . $nComm; $nComm++;}
 

Donde 321 es el ID de la categoría Sorteos y 1 el ID de mi usuario.

Ala, otra clase magistral de vuestro amigo Coco :p

© Rick's HideOut, 2008. | Permalink | Categorí­a: Wordpress | Tags: Sorteos

Si encontráis algún fallo, tenéis alguna sugerencia... ya sabéis...

© Rick's HideOut, 2008. | Permalink | Categorí­a: Plugins, Releases, Wordpress | Tags: microblogging, plurk

Templates
At least, a template for archives, author, links, search and 404 must be provided.

Alternate CSS file
In your header.php link your style.css and a alternate-style.css in order to allow users to add personal CSS code without fear to loose it in the next theme upgrade.

Supported plugins
Add support to 3rd parties plugins is good. But always check if they exists using function_exists() function to avoid PHP errors.

Time and Date format
Don't use your own time/date format with the_date() and the_time() functions. Use get_option() function, like the_date(get_option('date_format')) and the_time(get_option('time_format')) instead. And remenber, if you call the_date() function twice or more in one page, only the first will echo the date. the_time() function don't have this behavior.

Lightweight
Use WordPress own resources if is possible: i.e. don't add jquery.js, use wp_enqueue_script() function, like wp_enqueue_script('jquery'), and so on...

Widgets
Even if widgets are not your thing (like me), make your theme widget-ready. It's so easy, and sooner or later someone will ask you to do it.

© Rick's HideOut, 2008. | Permalink | Categorí­a: English, Wordpress | Tags:

Autor
Hacer una sección de autor no tiene mucho misterio: un email como mínimo y a partir de ahí, hasta el infinito y mas allá (redes de im, skype, nick y red de IRC, clave publica PGP, formulario de contacto, etc)

Archivo
El WordPress (y cualquier tema medio decente) viene con un archivo y una paginación decentes. Se pueden mejorar con plugins: yo recomiendo SRG Clean Archives y Pagebar2 para cada cosa, respectivamente.

Hora
Para añadir la hora a los posts, hay que ensuciarse un poco las manos y editar el tema: simplemente añadir la función the_time() donde sea conveniente (normalmente, al lado de the_date())

Colophon
Esta sección tambien es muy sencilla: Comentar con que esta creado el blog, de donde salen los gráficos, etc. Suele ser una buena sección para poner los correspondientes links de todo el material CC (si es que se usa alguna, claro). También se puede usar un plugin para mostrar que plugins se usan, como Plugins Used Plugin. Yo lo veo muy útil, pero hay quien lo ve como un problema de seguridad, ya que si usas un plugin que tenga algún bug de seguridad sabrán que lo estas usando.

Quicktags
Añadir estos botones tan útiles a los comentarios es tan fácil como usar uno de los muchos plugins (como no) que hay para eso, como LMB^Box Comment Quicktags, por ejemplo.

© Rick's HideOut, 2008. | Permalink | Categorí­a: Wordpress | Tags: consejos, how to

• Autor: Es increíble lo que hay que hacer para poder contactar con el autor de un blog a veces. Una página de Acerca de, Sobre mi o lo que sea con un par de datos básicos (una dirección de email, la del jabber/messenger, etc) es más que suficiente. Si ya pones un formulario de contacto, eso es para nota...
• Archivo: Por el amor de $DEITY, hacer el acceso a los archivos (entradas antiguas, vamos) lo más fácil posible: en la sidebar, el el footer, donde sea, pero que se vea. Imprescindible también el típico "Anterior...Siguiente" (o un plugin de paginación, ya que estamos) al FINAL de cada página, que al principio no vale para nada, que obliga a subir y bajar constantemente el scroll...
• Hora: Igual es cosa mía, pero a mi me gusta saber, amen de la fecha, a la hora a la que se publicó una entrada. Será una tontería, pero ayuda a ubicar temporalmente el asunto. Y no cuesta nada ponerla, ¿no?
• Colophon: Nunca está de más poner que plugins usas, o como haces esa cosa tan chula de la que estas tan orgulloso, etc. El tema es compartir tus conocimientos.
• Quicktags: Que te comenten en tu blog mola, esta claro. Pues facilítale la tarea poniendo unas quicktags, esos botoncicos tan bonitos que hacen que poner un link, negrita o cursiva sea mucho más fácil. Tus lectores son, por defecto, unos vagos, recuérdalo

Y por hoy ya me he despachado a gusto, ala :p

2da Parte: Requisitos mínimos de un Blog: How To

© Rick's HideOut, 2008. | Permalink | Categorí­a: Wordpress | Tags: blog, consejos, errores comunes

• Dashboard: Recent Posts Extended, cuya única y simple funcionalidad es mostrar los últimos posts escritos, pudiendo confugurar si mostramos la fecha y el autor....
• Dashboard: Technorati Reactions Extended, muestra las reactions de Technorati en vez de las de Google Bloag Search

La verdad es que son muy simples, y dude en si liberarlos o no, pero como no hacen daño a nadie e igual le son útiles a alguien, pues ahí estan...

© Rick's HideOut, 2008. | Permalink | Categorí­a: Plugins, Wordpress | Tags: dashboard, wigdets

Estos son lo widgets que me parecen más útiles (que no se porque no están integrados en el trunk del WordPress, la verdad)

• Berri Technorati Reactions on Dashboard (porque, sinceramente, el Blog Search de Google apesta...)
• Dashboard: Draft Posts
• Dashboard: Latest Spam
• Dashboard: Scheduled Posts
• WordPress.com Stats (no es un widget en si mismo, pero al usarlo en un WP2.5 pone uno en el dashboard)

Casi todos de Viper007Bond, desarrollador de WordPress, menuda máquina

Y no es un dashboard widgets, pero deberiaís tener instalado el Dashboard Widget Manager si o si: te permite organizar todos los dashboards widgets (ordenarlos, desactivarlos, etc...)

Non-Widget Bonus:

• Admin Drop Down Menu, convierte la barra de menus en una lista desplegable. Otra maravilla que debería venir de serie en el WordPress.
• Remove Max Width, para eliminar el max-width de la zona de administración (si tienes un panorámico lo agradecerás)
• Global Plugin Update Notice, y evita tener que ir mirando plugin por plugin si hay actualizaciones...

© Rick's HideOut, 2008. | Permalink | Categorí­a: Wordpress | Tags: dashboard widgets

Mañana haré más I+D+I...

© Rick's HideOut, 2008. | Permalink | Categorí­a: Wordpress | Tags: 2.5, actualizacion