Introduzione ai plugin ClipBucket

Argomenti monotematici pensati per aiutare gli utenti meno esperti, quindi tralasciando dettagli che potrebbero interessare solo il pubblico con conoscenze più approfondite.
Anto
Amministratore
Messaggi: 42
Iscritto il: domenica 11 ottobre 2015, 20:26

Introduzione ai plugin ClipBucket

Messaggio da Anto »

Questo è un tutorial molto semplice su come funzionano i plugin ClipBucket. Creare plugin per ClipBucket è abbastanza semplice, tutto ciò che devi fare è scrivere il tuo codice, registrare le tue anchor e il plugin è pronto.


Configurazione del plugin

Dove posizionare il tuo plugin
./plugins
Disposizione dei file
./plugins/file_tuo_plugin.php
./plugins/cartella_plugin/file_tuo_plugin.php
Installazione e disinstallazione plugin (opzionale)
./plugins/cartella_plugin/file_install_plugin.php
./plugins/cartella_plugin/file_uninstall_ plugin.php

Codice: Seleziona tutto

<?php
/*
Plugin Name: Nome_Plugin
Description: Descrizione_Plugin
Author: Nome_Autore
Author Website: https://forum.clipbucket.it/
ClipBucket Version: 4.1.x
Version: 1.0
Website:  https://forum.clipbucket.it/
*/

.

.

Il tuo codice

.

.
?>

Esempio

Con il codice seguente verrà creato un plugin in grado di inserire un annuncio globale.

Codice: Seleziona tutto

<?php
/*
Plugin Name: Nome_Plugin
Description: Descrizione_Plugin
Author: Nome_Autore
Author Website: https://forum.clipbucket.it/
ClipBucket Version: 4.1.x
Version: 1.0
Website:  https://forum.clipbucket.it/
*/

if(!function_exists('test_plugin'))
{
	function test_plugin()
    {
    	echo '<div style="background-color:#F7F7F7; border:1px solid #999; padding:5px; margin:5px; text-align:center">';
        echo "Testo del mio annuncio globale";
        echo '</div>';
    }

    //carica questo in ogni pagina
    register_anchor_function(array('test_plugin'=>'global'));

}

Registrazione delle anchor

La parte più importante di ClipBucket sono le anchor. Vediamo un esempio su come usarle:

Le anchor vengono utilizzate per richiamare le funzioni registrate:

Codice: Seleziona tutto

regiser_anchor_function('nome_anchor','nome_funzione');
nome_funzione verrà richiamato ovunque è stata inserita l'anchor:

Codice: Seleziona tutto

{ANCHOR place='nome_anchor'}

Aggiunta di più anchor

Codice: Seleziona tutto

<?php
/*
Plugin Name: Nome_Plugin
Description: Descrizione_Plugin
Author: Nome_Autore
Author Website: https://forum.clipbucket.it/
ClipBucket Version: 4.1.x
Version: 1.0
Website:  https://forum.clipbucket.it/
*/

if(!function_exists('test_plugin'))
{
	function test_plugin()
    {
    	echo '<div style="background-color:#F7F7F7; border:1px solid #999; padding:5px; margin:5px; text-align:center">';
        echo "Testo del mio annuncio globale";
        echo '</div>';
    }

    //carica questo in ogni pagina
    register_anchor_function('test_plugin','global');
    register_anchor_function('test_plugin','anchor_personale');

}
Ora apri ./styles/{TEMPLATE}/layout/index.html e incolla

Codice: Seleziona tutto

{ANCHOR place = 'anchor_personale'}
dove desideri visualizzare il tuo annuncio.


Installazione del plugin

Conclusa la creazione attiva il tuo plugin da pannello di amministrazione >> Plugin Manager >> e fare clic su Install Plugin in modo da poter utilizzare il plugin. Una volta conclusa l'installazione, il plugin verrà visualizzato nella parte superiore insieme agli altri plugin installati, mentre i plugin disponibili vengono visualizzati al di sotto di essi.

Codice: Seleziona tutto

Test del plugin
Dopo la corretta installazione, sarai in grado di vedere il tuo annuncio nei due punti che hai definito.