Archives For YOURLS

YOURLS in installazione self-hosted propone un proprio logo in alto a destra con relativo titolo (H1) bene in evidenza e, contrariamente per esempio a DokuWiki, non permette nativamente di modificarlo o eliminarlo (né il logo, né il titolo); avevo per questo motivo modificato manualmente il file PHP che inserisce il titolo e richiama l’immagine / logo, inserendo la mia icona e nulla più, “una roba un pelo più pulita“, inutile dire che questa soluzione è sconsigliata e da non percorrere (per svariati motivi che ti spiego tra un attimo), ecco perché alla fine ho deciso di scrivere un plugin per YOURLS che ti permette di fare tutto questo senza sporcarti le mani.

YOURLS: cambiare il logo con un plugin (GWallChangeLogo) YOURLS: cambiare il logo con un plugin (GWallChangeLogo) 1

GWallChangeLogo

Perché non modificare manualmente la pagina PHP?

Per svariati motivi, te ne cito un paio fondamentali (il secondo più del primo):

  • se non hai ben presente cosa stai facendo e dove stai mettendo le mani, potresti fare danni anche solo modificando una virgola;
  • ogni modifica operata manualmente verrà certamente sovrascritta al prossimo aggiornamento del software che installerai per questioni di sicurezza (vero che lo farai?), vuoi davvero andare a modificare ogni volta quel richiamo logo e titolo? Suggerimento: No.

È per questo che ho scritto un plugin: gratuito, codice pubblicamente disponibile (puoi lavorarci anche tu, che schifo non mi farebbe), facile da installare e configurare, puoi disattivarlo quando ti pare e decidere di tornare al logo originale di YOURLS, come nulla fosse mai accaduto, pillola azzurra.

Scarica il file PHP del plugin dallo spazio GitHub che gli ho dedicato (questo: github.com/gioxx/YOURLS-GWallChangeLogo), quindi caricalo nella cartella user/plugins del tuo YOURLS così ritrovarlo nella console amministrativa (contoso.com/admin/plugins.php dove contoso.com dovrà essere sostituito con l’URL della tua installazione YOURLS, ovviamente) e attivalo.

A questo punto spostati nella voce di menu GWall Change Logo Plugin Config e specifica i 3 parametri richiesti: URL dell’immagine da utilizzare al posto del logo originale, tag Alt e Title:

YOURLS: cambiare il logo con un plugin (GWallChangeLogo) 2

Non c’è limitazione sull’Image URL, il plugin proverà in ogni caso a fare l’img src dell’indirizzo che gli darai in pasto, occhio quindi a cosa gli riporti all’interno. I tag Alt e Title possono non essere specificati, ma per una questione di standard ti consiglio di farlo inserendo un testo alternativo all’immagine nel caso in cui questa non venisse trovata all’indirizzo specificato. Quando hai terminato, fai clic su Update values per confermare e permettere al plugin di terminare il suo lavoro.

Questo è quanto. Per qualsiasi dubbio l’area commenti è a tua disposizione così come l’area supporto / Issue di GitHub dove potrai segnalare malfunzionamenti o richiedere modifiche al plugin. Crediti e fonti utilizzate sono riportate all’interno del file PHP del plugin, grazie a chi mi ha permesso di imparare qualcosa in più su questo aspetto di YOURLS.


immagine di copertina: rawpixel.com from Pexels
Condividi l'articolo con i tuoi contatti:

Se non conosci YOURLS, è perché evidentemente non ti è mai servito e forse mai ti servirà, questo è il classico post tecnico dedicato a coloro che invece hanno già avuto a che fare con questo software e la sua necessità di aggiornamento old-school: “Scarica, scompatta, carica su FTP e sovrascrivi“. Un po’ sulla falsa riga di quanto fatto in passato con DokuWiki (DokuWiki: upgrade dell’installazione, poi non più necessario grazie all’implementazione nativa e alla disponibilità del file diff sul sito web dello sviluppatore), oggi torno sull’argomento e ti parlo del file diff di YOURLS.

YOURLS: upgrade dell’installazione (file diff) 1

YOURLS stands for Your Own URL Shortener. It is a small set of PHP scripts that will allow you to run your own URL shortening service (a la TinyURL or Bitly).

Running your own URL shortener is fun, geeky and useful: you own your data and don’t depend on third-party services. It’s also a great way to add branding to your short URLs, instead of using the same public URL shortener everyone uses.

Due file ZIP (quello contenente la vecchia versione, quello con all’interno la nuova) che si scaricano direttamente dallo spazio GitHub del progetto, un terminale di Linux (qualsiasi). Si scompattano entrambi i file ZIP (ex.: unzip 1.7.3.zip) nella stessa cartella, quindi il comando per il confronto tra le due directory rimane quasi lo stesso di quello usato per l’articolo del DokuWiki (non fosse che stavolta il mio Terminale è in lingua italiana):

diff -rs $1 $2 | awk '/sono identici/{print $5}' | xargs rm -v

Uso $1 e $2 perché sono variabili che posso dare in pasto a uno script di bash molto semplice, questo:

Il risultato è già pronto, si trova infatti all’interno del repository SomePublicStuff che tengo su GitHub, trovi la release più aggiornata all’indirizzo github.com/gioxx/SomePublicStuff/releases/tag/YOURLS-diff. Scarica il file ZIP, scompattalo e caricane il contenuto all’interno del tuo spazio FTP, dove tieni l’installazione di YOURLS.

Buon lavoro.


immagine di copertina: unsplash.com / author: Thomas Jensen
Condividi l'articolo con i tuoi contatti: