v1.0

Ultimo aggiornamento: 7 luglio 2008 (v 0.4.5)

Improved Include Page è un plugin per Wordpress che consente di includere in un template il contenuto di una pagina statica con diverse opzioni di visualizzazione. È una versione estesa del plugin Include Page di Brent Loertscher ed è stato sviluppato per aggiungere alcune caratteristiche di cui ho avuto bisogno creando questo sito.

Caratteristiche principali

• visualizzazione del titolo della pagina, utilizzando del codice HTML personalizzato,
• visualizzazione del contenuto della pagina in diversi modi (estratto, completo, con link ‘more’ personalizzabile),
• applicazione dei filtri per il contenuto e per il titolo.
• supporto per gli shortcode in WordPress 2.5.x

Note di versione (0.4.5)

• L’ID pagina può essere un percorso valido (es. ‘/about/resume’). Funzione abilitata solo per WordPress 2.1 o superiore.

Note di versione (0.4.4)

• Aggiunto il parametro $return (default = false) alla funzione iinclude_page()
• Aggiunto il supporto per le API Shortcode di WordPress 2.5.x

Note di versione (0.4.3)

Il codice di questa versione è stato ripulito e ottimizzato per utilizzare le API di WordPress.

Note di versione (0.4.2)

In questa versione è stato corretto un baco che genera un errore in alcune pagine statiche. La variabile globale $page viene quindi salvata e ripristinata prima di uscire dalla funzione.

Note di versione (0.4.1)

Questa versione contiene un bug fix di Jesse Plank: risolve un problema di compatibilità con il plugin EventCalendar.

Come si installa

1. Scarica Improved Include Page da questo sito oppure dal repository di Wordpress
2. Estrai l’archivio zippato
3. Carica il file iinclude_page.php nella cartella wp-content/plugins/
4. Accedi al pannello di amministrazione di Wordpress e attiva il plugin
5. Utilizza la funzione iinclude_page all’interno dei template o la sintassi dello shortcode in qualsiasi post o pagina.

Come si usa

Una volta installato il plugin aggiunge la funzione iinclude_page:

void iinclude_page(int post_id [,string params, boolean return = false])

La funzione accetta tre parametri: l’id della pagina da includere (post_id), una stringa opzionale (params) che determina la modalità di visualizzazione e un parametro boolean opzionale (return) per determinare se visualizzare il contenuto della pagina o restituirlo alla funzione chiamante.

Esempio 1: utilizzo di base

Per includere il testo della pagina che ha id 4 inserite nel file template che preferite (es. sidebar.php) il codice:

<?php iinclude_page(4); ?>

Per utilizzarlo in tutta sicurezza consiglio però quest’altro metodo:

 <?php if(function_exists('iinclude_page')) iinclude_page(4); ?>

Esempio 2: utilizzo dei parametri

Per personalizzare la visualizzazione aggiungendo il titolo della pagina:

<?php iinclude_page(4,'displayTitle=true&titleBefore=<h2 class="sidebar-header">'); ?>

Esempio 3: usare lo shortcode

È possibile includere il contenuto di una pagina statica in qualsiasi post o pagina con la sintassi:

[include-page id="123"]

oppure

[include-page id="3" displayTitle="true" displayStyle="DT_TEASER_MORE" titleBefore="<h3>" titleAfter="</h3>"  more="continue&raquo;"]

Parametri

La funzione attualmente supporta i seguenti parametri:

displayTitle (boolean)

mostra o nasconde il titolo

titleBefore/after (string)

stringhe da visualizzare prima e dopo il titolo

displayStyle (integer constant) - uno dei seguenti valori :

• DT_TEASER_MORE - Estratto con il link ‘more’ (default)
• DT_TEASER_ONLY - Solo estratto, senza il link ‘more’
• DT_FULL_CONTENT - Contenuto completo, incluso l’estratto
• DT_FULL_CONTENT_NOTEASER - Contenuto completo, escluso l’estratto

more (string)

testo visualizzato per il link ‘more’