Question

Me gustaría ordenar el código de mi plugin de Wordpress adecuadamente. Por ejemplo, el fichero principal mi_plugin.php es el siguiente:

defined( 'ABSPATH' ) or die( 'No script kiddies please!' );

include( plugin_dir_path( __FILE__ ) . 'admin/polr-metabox.php');
include( plugin_dir_path( __FILE__ ) . 'admin/admin-all-posts-page.php');
include( plugin_dir_path( __FILE__ ) . 'admin/admin-menu.php');
include( plugin_dir_path( __FILE__ ) . 'admin/plugins-page.php');
include( plugin_dir_path( __FILE__ ) . 'admin/settings-page.php');

// === ACTIONS === //

// show metabox in post editing page
add_action('add_meta_boxes', 'my_plugin_add_metabox' ); // admin/my_plugin-metabox.php

// Save metabox data
add_action('save_post', ',y_plugin_save_metabox' ); // // admin/my_plugin-metabox.php

// Muchas más acciones
.....

// DESPUÉS COMIENZAN LAS FUNCIONES // 

function my_plugin_plugin_load_textdomain() {
    //
}

function my_plugin_init() {
  //

}

Como se puede apreciar, comienzo realizando los includes necesarios. Después, registro las acciones asociadas a las funciones (algunas funciones están en este fichero PHP principal y otras en los indicados en los includes) y por último coloco las funciones.

Me gustaría saber si esta practicas es correcta. En ocasiones, entre otras cosas he visto como se escribe primero la función y después la acción que llama a esta función.

Answer 1

La estructura que planteas está bastante bien.

WordPress no aconseja ni desaconseja seguir ninguna estructura en particular. Lo que sí cambiaría es la forma con la que registras los hooks. Según la documentación de WordPress, se recomienda que las acciones se ejecuten solo si el plugin está activado, para ello se usa el register_activation_hook. Si lo haces con un add_action normal, cada vez que se lee ese php lo está ejecutando.

Aquí tienes la documentación con algunos ejemplos:
https://developer.wordpress.org/plugins/the-basics/activation-deactivation-hooks/

Por lo demás, un 10! :D

Answer 2

Yo estoy empezando aplicar un modo dividido por modulos como en otros frameworks.
Os dejo un enlace: https://github.com/PCianes/Collapsible-Content-Plugin