This Style (Plugin per WordPress)

Pensandoci non è utilissimo, ma a volte mi capita, soprattutto nella categoria Cascading Style Sheet di questo sito, di dover usare poche istruzioni CSS per creare degli esempi. Se anche voi avete esigenze simili e non volete appesantire troppo il foglio di stile principale, questo è il plugin che fa per voi.

Installazione.

1. Create una nuova cartella nella cartella wp-content/plugins e nominatela come this-style.
2. Copiate nella cartella this-style appena creata il file this-style.phps e rinominatelo come this-style.php (in pratica togliete la “s” finale).
3. Attivate il plugin dal pannello di amministrazione di WordPress.
4. Inserite tra gli HEAD del vostro template <link rel="stylesheet" type="text/css" xhref="<?php echo tstyle_url(); ?>” />, oppure <style type="text/css"><?php echo tstyle_css_script(); ?></style>.

Come applicare uno stile?

Dal pannello avanzato di scrittura dei post, inserite un nuovo campo personalizzato (custom field, se state usando una versione non localizzata) con chiave (key) this_style e utilizzate il campo valore (value) per scrivere il CSS da applicare al post (schermata 1).

Una volta inserito, vi apparir�  un form per, eventualmente, modificare o cancellare il codice CSS (schermata 2).

Con WordPress 2.0.

Con la versione 2.0 di WP la procedura è la stessa, ma affinchÃ?© il CSS venga generato dovrete applicare il campo personalizzato this_style dopo aver salvato il post. In alternativa rientrate nel post e aggiornare il campo this_style.

Possibili problemi di funzionamento.

Dopo aver applicato delle istruzioni CSS ad un post, nella cartella wp-content/plugins/this-style, dovrebbe esserci un file con estensione css. In caso contrario c’è un problema di scrittura che potrebbe essere causato da:

La cartella wp-content/plugins/this-style non ha i permessi di scrittura.

Se le impostazioni del server ve lo permettono modificatene i permessi. Di solido basta cliccare col tasto destro sulla cartella dal vostro client FTP, selezionare la voce Opzioni e spuntare le voci per abilitare la scrittura in quella cartella.

Se invece le impostazioni del server non vi permettono di modificare i permessi, spesso si ha comunque a disposizione una cartella in cui è abilitata la scrittura. In questo caso dovete settare la varibile $tstyle_path del plugin con il percorso di quella cartella (se utilizzate un percorso relativo, il percorso deve essere relativo alla cartella wp-admin e non a wp-content/plugins/this-style).

State utilizzando una versione di WordPress non compatibile con questo plugin.

Io l’ho testato con WP 1.5.2 e WP 2.0. Se state usando una versione diversa potete indicarmela nei commenti e tempo/capacitÃ?  permettendo proverÃ?² a farne una versione compatibile.

State usando WP 2.0 ed avete applicato lo stile prima di salvare il post.

In questo caso vi basta rientrare nel post e aggiornare il campo personalizzato.

Cosa cambia dalla funzione tstyle_url() a quella tstyle_css_script()?

tstyle_url restituisce (non stampa) il persorso del file CSS generato al momento del salvataggio del campo personalizzato, mentre tstyle_css_script restituisce direttamente tutto il codice CSS. Se si usa questa seconda funzione, non è necessario che il file CSS sia stato generato.

Log delle modifiche.

Modifiche al plugin:

• 0.3: Prima versione pubblica.
• 0.4: Aggiunto uno strip_tags alla funzione tstyle_css_script() per impedire l’inserimento di codice malevole tra gli head del documento.
• 0.4.1: Inserito un controllo per evitare la generazione di errori con certe configurazioni di PHP.

Modifiche a questo documento:

1 marzo 2005: Aggiunta la sezione Versioni derivate.

Versioni derivate.

Il coreano James G. Kim ha creato un omonimo plugin derivato da This Style. Le differenze più interessanti:

• Il richiamo al file CSS viene inserito atomaticamente dal plugin, quindi, una volta installato, non è necessario modificare il template.
• Nell’editor dei post compare una textarea più ampia per l’edizione del CSS.
• Le regole CSS vengono applicate solo al testo del post, aggiungendo un div con un identificativo univoco e una modifica dinamica del foglio di stile. Questo evita il rischio di aggiungere regole che agiscano in modo indesiderato su altre parti del documento, ma evita anche di aggiungere regole che agiscano su altre parti del documento in modo desiderato.
• Non crea i file CSS, ma li genera al volo estraendoli dal database.

Gli ultimi due punti rendono la creazione del documento da parte del server leggermente meno performante, dato che aggiungono una elaborazione ulteriore nella generazione dell’output e due query alle zero utilizzate dal mio plugin.

post<li>

tag: CSS, PHP, plugin, WordPress.

post correlati:

• Feed completi con il tag more in WordPress
• L'architettura a plugin di WordPress
• GT Post Approval [WordPress Plugin]
• Eliminare i rel="nofollow" dai link nei commenti di Wordpress
• Spleender Up: per terminare l'importazione di Spleender
• Migrare da Splinder/Motime a Wordpress.com
• Plugin per Wordpress più usabili usando l'hook activate_