Improved Include Page

Ultimo aggiornamento: 16 gennaio 2009 (v 0.4.7)

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.7)

  • Con WP 2.5 o superiore è possibile utilizzare i parametri ‘allowType’ e ‘allowStatus’ per specificate tipi e stati consentiti
  • Bug fix nella gestione shortcode che mandava in crash il PHP tentando di includere un post in se stesso

Nota importante sulla versione 0.4.6

Il fatto di poter includere articoli o pagine con stato diverso da “pubblicato” era un bug, ma a giudicare dai commenti recenti faceva comodo a molti di voi. Nell’attesa di una soluzione più “elegante” e personalizzabile, se avete bisogno di questa caratteristica potete modificare la riga 172.

Note di versione (0.4.6)

  • Bug fix: da questa versione è possibile includere solo pagine statiche con stato ‘pubblicato’.

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:

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

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]<?php iinclude_page(4);?>;[/php]

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

[php]<?php if (function_exists(‘iinclude_page’)) iinclude_page(4) ?>[/php]

Esempio 2: utilizzo dei parametri

Per personalizzare la visualizzazione aggiungendo il titolo della pagina:

[php]<?php if (function_exists(‘iinclude_page’)) iinclude_page(4, ‘displayTitle=true’) ?>[/php]

Esempio 3: usare lo shortcode

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

[sourcecode][include-page id="123"][/sourcecode]

oppure

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

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
allowStatus (string)
lista di stati consentiti separati da virgola (default = publish)
allowType (string)
lista di tipi consentiti separati da virgola (default = page)
more (string)
testo visualizzato per il link ‘more’