Documentazione - Skinning, Files e Estensioni
Lo Skinning
Per creare una skin di RockChock sono necessari vari file. Il più importante di tutti è sicuramente l'index.php, ovvero la pagina su cui si basa la home page, la visualizzazione di Articoli, categorie, pagine, registrazione e altre parti del sito.
Il file HTML deve essere compreso tra:
$tfile = <<<THEME
e
THEME;
?>
quanto al contenuto, potete utilizzare un qualsiasi template HTML, senza però inserire tags . per questi potete effettuare le operazioni sopra $tfile = <<
Ma ovviamente non dovete fare una pagina statica, ma un template per RockChock. Vediamo quindi i tag necessari a includere speciali variabili nella skin.
index.php
- <#DIR#> - con questo tag, verrà scritta la directory principale di RockChock. Ad esempio se il vostro portale si trova su www.host.com/cartella/ , <#DIR#> restituirà "/cartella/"
- <#DESC#> - questo tag scrive la descrizione della pagina attuale (ad esempio la descrizione generale del sito, quella di un articolo o di una categoria)
- <#TAGS#> - come <#DESC#>, solo che restituisce i Tags (Keyword)
- <#SITETITLE#> - scrive il titolo della pagina, ad esempio "Sito > Home", o "Sito > Categoria"
- <#SITENAME#> - il nome del sito (sempre fisso)
- <#CONTENT#> - stampa nel codice HTML il contenuto della pagina attuale. Per esempio potrebbe restituire tutta la homepage, solo un articolo con i commenti o la pagina di registrazione.
- {%CATEGORIE "prima,dopo"}- restituisce l'elenco delle categorie, aggiungendo ad ogni categoria all'inizio "prima" e alla fine "dopo".
- {%PAGINE "prima,dopo"} - come {CATEGORIE} , solo che resituisce l'elenco delle pagine
- {%FILE "nomefile" "argomenti"} - questa funzione restituisce il contenuto di un file presente nella cartella files/ di nome nomefile.php.
Gli argomenti devono essere divisi da una virgola (ad esempio: "arg1,arg2") e nel file sono richiamabili sotto i nomi $args[0], $args[1] (il primo è $args[0], il secondo $args[1], ecc.).
Nel caso il file non richieda argomenti, basta scrivere "" al posto di "argomenti" (ma non levate mai "" , altrimenti RC non riconoscerà il tag) - {%BLOCK "nomeblocco"} - questo comando restituisce il contenuto del blocco "nomeblocco" contenuto nel Database del sito. I Blocchi si possono creare dalla pagina "Admin Write Place", selezionando come tipo al posto di articolo, blocco
- <#VERSION#> - scrive il valore della versione di RockChock (ad esempio 0.8.1)
- {%EXT "nomeestension"} - in sviluppo (al momento non è in funzione). In ogni caso, dovrebbe essere il comando per la scrittura di un modulo di una determinata estensione.
Per ottenere funzionanti i comandi { }, togliete il carattere % dopo la parentesi graffa.
I Files
In Costruzione ...
Estensioni
In Costruzione ...
~ Rocklion il 15 Febbraio 2007, alle ore 22:52.
