Aldolat.it — Post con tag Plugin

Private Content 6.4.0

aldolat@gmail.com (Aldo Latino) — Sun, 28 Feb 2021 09:00:00 +0000

Ho rilasciato ieri la versione 6.4.0 del mio plugin per WordPress Private Content. Questo rilascio aggiunge la possibilità di mostrare una nota privata solo all’autore dell’articolo, quindi agendo in modo dinamico, senza doverne specificare il nome. La funzione è stata aggiunta a seguito della richiesta di un utente nel forum di WordPress, esattamente qui.

La nuova funzione si usa inserendo post-author nell’opzione role dello shortcode, per esempio:

[private role="post-author"]Text for the author of the post.[/private]

Con questo shortcode, solo l’autore del post e il ruolo Amministratore vedranno la nota privata.

Se invece si vuole escludere anche il ruolo Amministratore, bisognerà usare post-author-only, ad esempio:

[private role="post-author-only"]Text for the author of the post.[/private]

Come per gli altri casi, si può usare l’opzione alt per mostrare un testo alternativo per gli altri utenti, se si vuole.

Per avere una panoramica dei vari casi utilizzabili per l’opzione role ecco un’immagine, spero esplicativa:

Tra le varie versioni ho aggiunto il manuale del plugin in formato wiki e PDF, dove ho tentato di spiegarne l’uso. Entrambi sono disponibili su GitHub: qui il wiki e qui il PDF.

Una seconda novità introdotta da questa versione è il modo con cui il plugin costruisce le classe per il paragrafo che viene fuori. Come già sa chi usa questo plugin, con l’opzione class si possono specificare le classi personali da aggiungere al paragrafo. La novità è che ora gli eventuali underscore (_) saranno cambiati in trattini (-). Quindi, ad esempio, in questo schortcode:

[private class="myclass1, custom-class-2, my_class_3"]Private text.[/private]

la classe my_class_3 diverrà my-class-3.

Il plugin è disponibile nel repository di WordPress:

https://it.wordpress.org/plugins/private-content/

L'articolo Private Content 6.4.0 è uno scritto di aldolat.it. Rispettane le condizioni di licenza.

Search Regex 2.0

aldolat@gmail.com (Aldo Latino) — Sun, 10 May 2020 08:51:40 +0000

Finalmente, dopo 4 anni, Search Regex è stato aggiornato alla nuova versione 2.0. Ormai pensavo che questo plugin per WordPress fosse stato abbandonato, e invece eccolo qui vivo e vegeto e riscritto da zero (“a ground-up rewrite”, dal Changelog).

La versione 1.4.16 rilasciata il 28 marzo 2016.

Qui sopra la versione 1.4.16 rilasciata il 28 marzo 2016, qui sotto la versione 2.0 rilasciata proprio ieri.

La versione 2.0 rilasciata proprio ieri.

Grazie @johhny5, per il lavoro fatto!

L'articolo Search Regex 2.0 è uno scritto di aldolat.it. Rispettane le condizioni di licenza.

Quando il nome del tuo plugin non aiuta

aldolat@gmail.com (Aldo Latino) — Sun, 17 Nov 2019 08:51:40 +0000

Chi segue questo blog magari si ricorderà che nel 2010 creai un plugin per mostrare una porzione del testo di un articolo o di una pagina solo a determinati ruoli di WordPress. Quel plugin, che creai a maggio del 2010 e resi disponibile al download dal sito digwp.com di Jeff Starr, è nei repository di WordPress da novembre del 2012.

Questo plugin si chiama Private Content. Un nome come un altro, ma purtroppo si è rivelato nel tempo eccessivamente semplice da usare per altri sviluppatori di plugin. Quantomeno nel repository di WordPress ce n’è uno che si chiama WP Private Content Plus e, nel repository di CodeCanyon, uno che ha lo stesso identico nome del mio, cioè Private Content, appunto.

Questa cosa ha causato negli anni, compreso oggi, non poche noie, sia a me che agli utenti. Cominciamo dall’ultimo plugin, quello ospitato su CodeCanyon.

Private Content su codecanyon.net

Avendo questo plugin lo stesso identico nome del mio, succede che agli utenti del plugin di CodeCanyon — quando io pubblico un aggiornamento — WordPress sovrascrive la directory del plugin installato con quella del mio plugin.

In altre parole, se un utente usa Private Content di CodeCanyon e io pubblico un aggiornamento del mio plugin (che è tutto un altro plugin), WordPress gli installa il mio, con tutti i problemi che potete immaginare.

Il plugin ospitato su CodeCanyon gestisce tutta una serie di funzioni (tra cui, se ho capito bene, autenticazione degli utenti, visibilità di contenuti a pagamento e cose simili), col risultato che, in caso di sovrascrittura del plugin legittimo, l’amministratore si ritrova con un plugin del tutto diverso e una situazione completamente sottosopra: dopo essersene accorto, dovrà ripristinare la situazione subito, altrimenti addio a tutti i permessi che aveva impostato.

Com’è possibile che succeda questo? WordPress (almeno per ora) non ha una gestione dei plugin basata su firma crittografica, hash o tecniche di questo tipo, ma si basa, per aggiornare un plugin, sullo slug del plugin, slug che coincide col nome della directory dove viene ospitato sul suo repository. Quindi, se nel sito dell’utente la directory che contiene il plugin di CodeCanyon si chiama private-content e WordPress si accorge che il plugin Private Content fatto da Aldo (che ha lo stesso slug private-content) è stato aggiornato rispetto a quello installato, WordPress lo “aggiorna”, sostituendo il contenuto della directory.

Ho perso il conto di quanti utenti mi hanno segnalato questa cosa, ma non posso farci niente. Avrei dovuto, semmai, scegliere un nome più complicato, ma non era semplice immaginarsi una cosa di questo tipo.

WP Private Content Pro su wordpress.org

La storia con questo plugin è invece recentissima. Non mi era mai capitato di imbattermi in problemi con lui.

Oggi, di prima mattina, insieme col caffè mi arriva la segnalazione che un utente ha lasciato una recensione a una stella su questo plugin. Apro la recensione e leggo:

Easily infected! Addirittura! 😀 Ho notato subito, però, quel wppcp_options che il mio plugin non crea assolutamente nel database. Immediatamente ho capito che si trattava di un’altro scambio di plugin: l’autore della recensione, mi sono detto, ha sbagliato posto.

Cerco subito quale plugin possa creare quell’option name nella tabella delle opzioni di WordPress. Non mi ci è voluto molto a trovare il plugin WP Private Content Plus (notate il prefisso del nome delle opzioni wppcp_ che combacia con questo nome). Ho anche notato che nelle recensioni di questo plugin diversi utenti hanno segnalato (scorrettamente, perché non si fa così) problemi di sicurezza di questo plugin, ormai risolti a detta del suo autore.

Ho fatto presente all’autore della recensione l’errore:

Ho atteso quasi tutto il giorno. Nel tardo pomeriggio ho aggiunto un altro commento alla recensione, ma questa volta rivolgendomi ai moderatori e aggiungendo alla recensione il tag modlook, fondamentale per far intervenire i moderatori:

Pochi minuti dopo, un moderatore è intervenuto e, dopo aver lasciato un commento, ha cancellato la recensione. Ecco cosa ha scritto:

@xxxyyyzzz

It appears you’ve posted this incorrectly so I’m removing it.

Reviews are not how you should deal with a potentially vulnerable plugin. Please see https://developer.wordpress.org/plugins/wordpress-org/plugin-security/reporting-plugin-security-issues/ for the proper procedure.

Steve Stern, su wordpress.org

Il punto 1 era palese: il recensore si era sbagliato sulla pagina dove scrivere. Il punto 2 è interessante perché tiene conto della responsible disclosure: detto in breve, se trovi una vulnerabilità, non spiattellarla subito ai quatto venti, ma avvisa in privato chi di competenza e dai un tempo massimo per la risoluzione del problema, al cui scadere renderai pubblica la vulnerabilità.

Poco fa l’autore della recensione si è scusato via email e mi ha anche ringraziato per averlo guidato.

Ecco, tutto questo per dire che, se avessi usato un nome del tutto diverso da Private Content, di certo in questi anni non avrei dovuto perdere tempo dietro a queste storie.

L'articolo Quando il nome del tuo plugin non aiuta è uno scritto di aldolat.it. Rispettane le condizioni di licenza.

Una pezza per SyntaxHighlighter

aldolat@gmail.com (Aldo Latino) — Sat, 19 Jan 2019 20:21:19 +0000

Con una funzione molto semplice è possibile mettere una pezza al problema del plugin SyntaxHighlighter, che segnalavo qui.

Grazie a @kaggdesign per la condivisione.

L'articolo Una pezza per SyntaxHighlighter è uno scritto di aldolat.it. Rispettane le condizioni di licenza.

WordPress 5, SyntaxHighlighter Evolved e il carattere «&»

aldolat@gmail.com (Aldo Latino) — Wed, 09 Jan 2019 18:24:17 +0000

C’è attualmente un problema, confermato da Alex Mills, a.k.a. @viper007bond, circa il corretto escaping del carattere & in WordPress. Trovate la mia discussione con Alex nel forum di WordPress.

Dalle mie prove sembrerebbe che il problema si presenti solo nei pezzi di codice pubblicati in un post usando il plugin SyntaxHighlighter Evolved. Ad esempio:

Qui ho usato il blocco standard di WordPress per il codice e il carattere è correttamente mostrato.

Qui, invece, usando il blocco del plugin SyntaxHighlighter Evolved, no.

Alex ha aperto un ticket su Github in quanto dipenderebbe da WordPress.

L'articolo WordPress 5, SyntaxHighlighter Evolved e il carattere «&» è uno scritto di aldolat.it. Rispettane le condizioni di licenza.

Facciamo il punto sul mio plugin “Posts in Sidebar”

aldolat@gmail.com (Aldo Latino) — Sun, 06 Jan 2019 09:30:39 +0000

L’ultima volta che ho scritto di Posts in Sidebar è stato il 2 giugno 2013 e, da allora, sono stati fatti tanti rilasci di questo mio plugin. Tante ore spese a scrivere codice, fare debug e dare assistenza nel forum. Nato da un’esigenza puramente personale, il plugin venne pubblicato perché era giusto consentire ad altri di poterne trarre qualche vantaggio e, a quanto pare, viene usato da un po’ di utenti.

Dalla versione 1.7, di cui scrivevo appunto nel giugno 2013, siamo arrivati alla versione 4.7.3. Il plugin è cambiato parecchio e tante funzioni sono state aggiunte: diciamo che l’oggetto WP_Query è abbastanza “alla portata di widget”. Dalla galleria di foto qui sotto (fare clic per ingrandire l’immagine) si vede come il plugin sia cresciuto: nella versione 1.0 le opzioni stanno tutte su una schermata, come anche nella successiva 1.7 anche se aumentate, mentre nell’attuale 4.7.3 sono cresciute a dismisura tanto che stanno quasi tutte racchiuse dentro pannelli e sottopannelli (ogni box verde è un pannello che si espande e si contrae con un clic):

Il pannello delle opzioni di Posts in Sidebar 1.0.

Il pannello delle opzioni di Posts in Sidebar 1.7.

Il pannello delle opzioni di Posts in Sidebar 4.7.3.

A cosa serve questo plugin

I sottopannelli dedicati alla personalizzazione della query.

Questo plugin serve a mostrare nella sidebar alcuni post scelti secondo determinati criteri. Ad esempio:

mostrare gli ultimi post;
mostrare gli ultimi post pubblicati in una o più categorie o in uno o più tag;
mostrare post a caso;
mostrare post a caso ma aventi certe tassonomie (categorie, tag, formati di post, ecc.);
mostrare post con un certo stato (pubblicato, programmato, bozza, in attesa di revisione, ecc.);
mostrare post di un certo autore;
mostrare post con determinati campi personalizzati;
mostrare post pubblicati in certi intervalli di date;
mostrare post risultanti da una ricerca;
mostrare post mediante query complesse di tassonomie;
mostrare un determinato gruppo di post in tutte le pagine e, invece, i post dell’autore dell’articolo corrente quando si visualizza un articolo singolo;
mostrare i post di una delle categorie del post quando si visualizza un articolo singolo;
e altro ancora.

Oltre a ciò è possibile scegliere cosa visualizzare del post: oltre al titolo, si può scegliere se mostrare anche un estratto (o un altro tipo di testo); si può mostrare l’immagine in evidenza, le categorie, i tag, le tassonomie personalizzate, la data, ecc.

Il prezzo di questo plugin

Posts in Sidebar è distribuito gratuitamente nel repository di WordPress ed è pubblicato sotto licenza GPL v3. Chi ha pagato tanto in termini di tempo e fatica sono io, ma l’ho fatto divertendomi. Quando, a volte, in alcune applicazioni disponibili sulla rete vedo la riga che dice Made with love in California (o altrove), ecco ritengo che sia molto vero se penso alla mia esperienza di lavoro sui miei plugin. 🙂

L’assistenza nel forum

Uno dei punti cardine dello sviluppo di Posts in Sidebar è stato il mio rapporto con gli utenti nel forum. Sempre rispettosi dello sviluppatore del plugin, mi hanno chiesto assistenza nell’uso ma soprattutto nell’adattamento dell’aspetto alla grafica del tema. Il plugin, infatti, non ha una grafica sua e visualizza i post senza interporre nulla a livello di CSS (se non quando esplicitamente si attivano alcune opzioni dedicate). Spessissimo mi hanno anche chiesto assistenza su cose che esulavano del tutto dal plugin, ma non mi sono tirato indietro e non li ho mai liquidati con risposte sbrigative, cercando invece di immedesimarmi e di dar loro il supporto richiesto.

Il widget che questo plugin genera è stracarico di opzioni. Molte le ho aggiunte io, nel tentativo di rendere facilmente disponibile a tutti la potenza di WP_Query, ma molte opzioni nascono nascono proprio da loro richieste. A memoria mia credo di averne respinte poche, perché le reputavo interessanti e utili per altri eventuali utenti.

Il futuro dello sviluppo

Ad oggi non ho molto da aggiungere al plugin, perché credo di essere molto vicino al traguardo che mi ero prefissato: poter estrarre i post desiderati dal database e mostrarli in un widget.

A livello di scrittura del codice confesso che mi sarebbe piaciuto programmarlo ad oggetti, ma non ho mai avuto il tempo di imparare. Non programmo per mestiere e guardando il codice si vede, ma oltre non potevo andare.

L'articolo Facciamo il punto sul mio plugin “Posts in Sidebar” è uno scritto di aldolat.it. Rispettane le condizioni di licenza.

Il plugin «Health Check & Troubleshooting»

aldolat@gmail.com (Aldo Latino) — Thu, 27 Dec 2018 13:52:56 +0000

Una delle prime cose da fare quando si deve risolvere un problema in WordPress è quella di disabilitare tutti i plugin e di attivare uno dei temi di default, perché spesso il problema è proprio uno dei plugin oppure il tema in uso. Potrebbe anche essere un problema non di un plugin in se stesso o del tema in uso, ma di un’incompatibilità fra un plugin e un altro o di un plugin con quel tema specifico in uso. Bisogna quindi riportare WordPress a una situazione quanto più pulita possibile e vedere se il problema si ripresenta.

Una volta ripristinata una situazione «pulita», si procede col riattivare manualmente uno dei plugin e vedere se il problema si ripresenta. Se il problema non si manifesta, si procede con la riattivazione di un altro plugin e col successivo controllo, e così via fino alla riattivazione di tutti i plugin e infine del tema stesso: di solito, con questo sistema, si riesce a trovare chi sta causando il problema.

Tutto questo comporta che il sito, durante la fase di debugging, si troverà ad essere pubblicato senza il solito tema e senza i plugin di supporto. Per questo motivo, di solito, questa fase di ricerca del problema va fatta mettendo il sito in modalità manutenzione, tenendo quindi fuori gli utenti.

Per ovviare a tutto ciò è stato creato un plugin ad hoc: Health Check & Troubleshooting, creato da The WordPress.org community, di cui non conoscevo l’esistenza fino a qualche giorno fa, quando ho notato una incompatibilità fra una funzione specifica di un mio plugin personale (non pubblicato) e Gutenberg.

Una volta installato, è raggiungibile dal menu Bacheca > Health check. Tra le cose che offre, sottolineo quelle che mi interessano più da vicino e che sono utilissime quando gli utenti ti chiedono supporto su qualcosa che non va con WordPress:

disattivare in un colpo solo tutti i plugin;
attivare il tema di default di WordPress;
avere questa situazione vanilla solo per il nostro utente, mentre tutti gli altri visualizzeranno il sito come al solito.

Davvero notevole il fatto che solo il nostro utente vedrà questi cambiamenti, cosa che ci consente di operare con abbastanza tranquillità. In questa condizione si provvede alla solita scaletta di attivazione manuale dei plugin uno alla volta, finché non si isolerà il problema.

Oltre a quanto detto, il plugin offre anche un utile servizio di controllo dell’integrità dei file. Se un file di sistema è stato modificato, viene mostrato come in figura qui sotto:

Nel caso specifico della foto si tratta di una modifica che apporto ogni volta che aggiorno WordPress in quanto SimplePie, fornito in bundle con WordPress, non è aggiornato e ha qualche problema con PHP 7.

La riga di WordPress che modifico è la n. 694 del file /wp-includes/SimplePie/Parse/Date.php. La riga originale di WordPress è la seguente:

$second = round($match[6] + $match[7] / pow(10, strlen($match[7])));

che modifico con questa:

$second = round((int)$match[6] + (int)$match[7] / pow(10, strlen($match[7])));

Ecco una rapida carrellata di schermate del plugin:

Finalmente ho un plugin da consigliare quando qualcuno mi chiede assistenza! Se volete approfondire su questo plugin, potete dare un’occhiata alla pagina dedicata nell’Handbook di WordPress.

L'articolo Il plugin «Health Check & Troubleshooting» è uno scritto di aldolat.it. Rispettane le condizioni di licenza.

Posts in Sidebar 1.7

aldolat@gmail.com (Aldo Latino) — Sun, 02 Jun 2013 05:41:30 +0000

A piccoli passi il plugin Posts in Sidebar sta crescendo e ieri ha raggiunto la versione 1.7 con alcune aggiunte che faranno piacere di certo a qualche utente. Ho visto infatti che c’è un base di utenza affezionata che interagisce sia tramite il forum sia via email e, oltre a richieste di supporto, lanciano idee assolutamente condivisibili. Il più delle volte ho cercato di accontentarli: un esempio è questo post.

Oltre a migliorie varie, le novità di questa versione sono:

la possibilità di prelevare non solo i post “classici”, ma anche i post personalizzati (i Custom post types) e le pagine statiche;
ora il contenuto del post può essere mostrato nella sua pienezza, proprio come WordPress lo mostra quando si legge la pagina del post singolo (utile, a mio avviso, per post composti solo da un video, ad esempio);
è possibile adesso definire un testo per il classico “Continua a leggere…”, anziché vedere solo la freccia a destra (il carattere ?);
è possibile anche mostrare l’autore del post, il cui nome può essere collegabile alla pagina del suo archivio di post (questa è stata, come il punto precedente, più una dimenticanza che altro, ma essendo nato il plugin per scopi inizialmente personali non mi era necessario mostrare l’autore del post);
il plugin è stato tradotto in francese, grazie a Thérèse Lachance.

In una prossima versione, che dovrei rilasciare a breve, troverete anche l’opzione per prelevare post con un certo formato: ad esempio, sarà possibile prelevare post che abbiano “Video” oppure “Galleria” come loro formato. Questa funzione è già implementata nella versione in sviluppo 1.8 su GitHub, ancora quindi da revisionare.

Un’altra funzionalità che ho intenzione di aggiungere è quella di prelevare i post mediante le tassonomie personalizzate (Custom taxonomies).

L'articolo Posts in Sidebar 1.7 è uno scritto di aldolat.it. Rispettane le condizioni di licenza.

Concedete una pausa al file functions.php

aldolat@gmail.com (Aldo Latino) — Tue, 27 Nov 2012 21:51:22 +0000

Ryan, di WPCandy, chiama il file functions.php di WordPress the poor guy e scrive che si merita una pausa. E ha ragione. Qualche mese fa scrissi un post invitando coloro che aggiungono funzioni aggiuntive al proprio blog utilizzando questo file a crearsi un plugin apposito che le contenga. Nel suo post Ryan tratta questo argomento e lo estende in maniera interessante.

L'articolo Concedete una pausa al file functions.php è uno scritto di aldolat.it. Rispettane le condizioni di licenza.

Plugin Private Content

aldolat@gmail.com (Aldo Latino) — Sun, 25 Nov 2012 11:10:18 +0000

Ieri ho caricato sul repository di WordPress il mio plugin Private Content, di cui feci cenno qualche anno fa. Il plugin, che veniva distribuito da Jeff nel suo sito, adesso è disponibile comodamente dalla dashboard del nostro CMS.

A che serve

Come spiegavo nel mio vecchio articolo, esso serve a nascondere parte del testo di un articolo a tutti tranne a coloro che fanno parte di un determinato ruolo. In un blog strutturato e con diversi contributori con ruoli diversi (Amministratori, Editori, Autori, Collaboratori, Sottoscrittori) può essere utile mostrare parti del testo solo a certi ruoli.

Si tenga presente che, diversamente da come scrivevo nel mio vecchio post, non è possibile mostrare solo ed esclusivamente a un determinato gruppo una parte di testo. Non è possibile, ad esempio, mostrare solo al gruppo Autori quel testo perché i ruoli con poteri superiori, come gli Editori e gli Amministratori potranno leggerlo.

Aggiornamento

Dalla versione 2.0 è possibile mostrare il testo nascosto solo a quei ruoli cui è destinato. Ad esempio, un pezzo di testo può essere mostrato agli Autori soltanto, escludendo sia i ruoli inferiori che superiori.

Come si usa

Si usa tramite shortcode indicando il ruolo cui è destinato quel testo. Ad esempio:

[private role="author"]Autori, attenzione! Questo è un testo per voi.[/private]

Se non si specifica il ruolo di destinazione, quello predefinito è “Administrator”:

[private]Amministratori, attenzione! Questo è un testo per voi.[/private]

I ruoli che usa il plugin sono quelli standard di WordPress, in ordine descrente riguardo le capacità:

administrator
editor
author
contributor
subscriber

L’amministratore legge i suoi messaggi e quelli destinati ai ruoli inferiori; l’edtore ugualmente, ma non quelli destinati a chi gli sta sopra, e così via.

Evidentemente, se disinstallate o disattivate questo plugin, tutte le “note private” verranno rese visibili a tutti.

Download e installazione

La pagina ufficiale del plugin, presente nei repository di WordPress, è la seguente: http://wordpress.org/extend/plugins/private-content/ ma può essere installato, come dicevo, dalla dashboard di WordPress.

Una volta installato, lo shortcode è immediatamente disponibile. Non c’è alcuna pagina di impostazione, né opzioni da configurare.

Riconoscimenti

È doveroso riconoscere i meriti alle seguenti persone:

A Jean-Baptiste Jung per il primo suggerimento in merito a questa possibilità, come spiegava nel suo vecchio articolo;
A Jeff Starr per aver colto il suo suggerimento e aver dato l’idea di uno shortcode.

Io, poi, decisi di farne un comodo plugin.

L'articolo Plugin Private Content è uno scritto di aldolat.it. Rispettane le condizioni di licenza.