Wiki Marco Cerutti - Contributi dell'utente [it]

Plugin base

2025-08-13T13:03:59Z

151.81.60.81:

== Info ==
Struttura modulare, basata su classi, con il supporto integrato per REST API e AJAX.

<pre>
my-plugin/
│
├── my-plugin.php # File principale del plugin
├── uninstall.php # Disinstallazione pulita
│
├── includes/
│ ├── Core/
│ │ ├── Plugin.php # Classe principale che avvia il plugin
│ │ └── Loader.php # Classe che carica tutte le componenti
│ │
│ ├── Admin/
│ │ └── SettingsPage.php # Pannello admin nel backend
│ │
│ ├── Frontend/
│ │ └── ShortcodeHandler.php # Gestione shortcode e risorse frontend
│ │
│ ├── Api/
│ │ └── RestRoutes.php # Definizione di una rotta REST API
│ │
│ └── Ajax/
│ └── AjaxHandler.php # Gestione delle chiamate AJAX
│
├── assets/
│ ├── css/
│ ├── js/
│ └── images/
│
└── templates/
└── admin-settings.php # HTML della pagina di impostazioni admin

</pre>

== LOGICA DEL PLUGIN ==

=== my-plugin.php – File di bootstrap ===

Avvia il plugin caricando la classe Plugin.

<pre>
require_once plugin_dir_path(__FILE__) . 'includes/Core/Plugin.php';

function run_my_plugin() {
$plugin = new MyPlugin\Core\Plugin();
$plugin->run();
}

run_my_plugin();

</pre>

=== Plugin.php – Punto di ingresso OOP ===

Crea una nuova istanza del Loader, che inizializza tutte le funzionalità.

<pre>
class Plugin {
public function run() {
$loader = new Loader();
$loader->init();
}
}

</pre>

=== Loader.php – Inizializzazione dei moduli ===

<pre>
class Loader {
public function init() {
if (is_admin()) {
(new \MyPlugin\Admin\SettingsPage())->register();
} else {
(new \MyPlugin\Frontend\ShortcodeHandler())->register();
}

// Extra
(new \MyPlugin\Api\RestRoutes())->register();
(new \MyPlugin\Ajax\AjaxHandler())->register();
}
}

</pre>

Carica:

* la pagina admin se sei nel backend
* gli shortcode e gli script se sei nel frontend
* sempre la REST API e l’AJAX handler

=== SettingsPage.php – Menu nel pannello admin ===
Aggiunge un menu personalizzato in Impostazioni > Il Mio Plugin.

=== ShortcodeHandler.php – Gestione frontend ===
* Registra uno shortcode [my_shortcode]
* Carica un file CSS dal plugin
* Ritorna un blocco HTML nel contenuto del post

== REST API – RestRoutes.php ==

'''Rotta'''
<pre>
GET /wp-json/myplugin/v1/hello
</pre>
'''Risposta'''
<pre>
{ "message": "Ciao dal plugin!" }
</pre>
'''Codice'''
<pre>
register_rest_route('myplugin/v1', '/hello', [
'methods' => 'GET',
'callback' => [$this, 'handle_hello'],
'permission_callback' => '__return_true'
]);
</pre>

== AJAX – AjaxHandler.php ==

'''Azioni registrate:'''
<pre>
add_action('wp_ajax_myplugin_action', [$this, 'handle']);
add_action('wp_ajax_nopriv_myplugin_action', [$this, 'handle']);
</pre>
'''JS (esempio per usarlo):'''
<pre>
jQuery.post(
myplugin_ajax.ajax_url,
{ action: 'myplugin_action' },
function(response) {
console.log(response.data.message);
}
);
</pre>
Puoi localizzare lo script con wp_localize_script() per passare ajax_url.

== uninstall.php ==
Contiene il codice di disinstallazione.

Plugin base

2025-08-13T13:03:03Z

151.81.60.81:

Plugin base

2025-08-13T13:01:34Z

151.81.60.81:

Plugin base

2025-08-13T12:59:41Z

151.81.60.81: /* LOGICA DEL PLUGIN */

Plugin base

2025-08-13T12:58:17Z

151.81.60.81: /* LOGICA DEL PLUGIN */

Plugin base

2025-08-13T12:56:59Z

151.81.60.81: /* LOGICA DEL PLUGIN */