eIrOcA

Dokuwiki Plugin - GPlusOne

Anonymous (anonymous@undisclosed.example.com) — 2019-02-24T16:21:25+0000

Dokuwiki Plugin - GPlusOne

Plugin Dokuwiki per aggiungere il pulsane “+1” di Google.

Il plugin nasce dal fatto che quello esistente http://www.dokuwiki.org/plugin:googleplusone non soddisfa i miei requisiti: la posizione del bottone è fissa, è supportato solo il tedesco, non è possibile personalizzare l'aspetto del bottone, … da qui la necessità di mettere le mani al codice.

La scelta è stata di partire da zero, l'approccio jQuery del plugin originario non mi piaceva e nel plugin mancava completamente l'amministrazione/integrazione con l'editor. Ovviamente partire da zero significa “reciclare” il template già utilizzato per gli altri plugin…

Utilizzo del plugin

Genera il bottone “+1” usando le API di Google.

Sintassi

~~GPLUSONE~attributo1=valore1~attributo2=valore2~~

I possibili valori, tutti opzionali, sono quelli presenti nella documentazione di Google. Se assenti vengono presi i valori di default amministrabili da interfaccia di amministrazione.

Esempi

~~GPLUSONE~annotation=bubble~size=tall~~

genera il seguente risultato: ~~GPLUSONE~annotation=bubble~size=tall~~

Istallazione

Scaricare e installare il plugin tramite il Plugin Manager usando il seguente URL http://www.eiroca.net/apps/dokuwiki/dokuwiki-plugin-gplusone.zip. Oppure installarlo manualmente (vedere plugins) usando il codice, sempre aggiornato, che si ottiene dalla sezione rilasci di github.

Amministrazione

I valori di default della generazione bottone “+1” essere cambiati da pannello di controllo.

Versioni

Versione 19.02

Supporto a spegnimento Google+
Supporto a dokuwiki “Greebo”
Supporto a PHP 7.x

Versione 2013/06/29

Prima versione

Licenza & Copyright

Questo programma è software libero, è possibile ridistribuirlo e/o modificarlo secondo i termini della GNU General Public License pubblicata dalla Free Software Foundation; nella versione 3 o (a propria scelta) qualunque versione successiva.

Questo programma è distribuito nella speranza che possa essere utile, ma SENZA ALCUNA GARANZIA implicita o esplicita di COMMERCIABILITÀ o IDONEITÀ PER UN PARTICOLARE SCOPO. Vedere la GNU General Public License per maggiori dettagli.

Insieme al programma ci dovrebbe essere una copia della GNU General Public License, se no, scaricala da http://www.gnu.org/licenses/.

DokuWiki, Google, PHP

Dokuwiki Template - eIrOcA

Anonymous (anonymous@undisclosed.example.com) — 2019-01-19T16:07:07+0000

Dokuwiki Template - eIrOcA

Tecnicamente il restyling ha richiesto la creazione di un nuovo template per DokuWiki e il rinnovamento delle mie maledizioni verso CSS e JavaScript, come rimpiango la prima versione del sito dove era motivo di orgoglio la scritta “No JavaScript” (e i CSS non esistevano ancora :)

Essendo passato molto tempo dalla scrittura del primo template di eIrOcA ho pensato che fosse meglio ripartire dal nuovo template di default, piuttosto che far evolvere il vecchio template. Sulla carta i vantaggi erano tanti, il template è responsive, è allineato alle nuove versioni, non fa uso di tabelle per il layout dei testi, … ovviamente iniziando a lavorarci su sono emerse tutte le limitazioni. Il template è ha una naming sulle classi/id non proprio intuitivo e la struttura dei div e CSS è un fragile castello di carta che crolla non appena si tenta di introdurre qualche stravolgimento (ma qui sono i CSS a metterci molto del loro).

Dopo un giorno di progressi quasi nulli è arrivato il tempo di cambiare rotta e riscrivere il layout da zero. Qui all'inizio i progressi sono stati eclatanti, finalmente non era più necessario cercare di capire in che file fossero i frammenti di CSS che impattavano il layout di qualche sezione, i problemi sono arrivati dopo, quando in funzioni secondarie della wiki o in qualche plugin si faceva riferimento a un naming/struttura non più esistente (e in questo senso direi che i lavori non sono ancora finiti).

Inutile dire che chi usa delle (vecchie) versioni di explorer avrà sicuramente dei problemi nella visualizzazione di alcune parti del sito, ma i dati di accesso da parte di questi browser non giustificano l'accanimento terapeutico…

Non appena sarò riuscito a fare un po' di testing su tutte le funzionalità (anche quello non usate all'interno del sito di eIrOcA) cercherò di rilasciare il template all'interno del repositori ufficiale di DokuWiki, fino ad allora la versione in sviluppo è disponibile all'interno del code repository di SourceForge.

DokuWiki, template, PHP

Dokuwiki Plugin - OrgApp

Anonymous (anonymous@undisclosed.example.com) — 2019-02-24T19:38:22+0000

Dokuwiki Plugin - OrgApp

Plugin Dokuwiki per disegnare organigrammi.

Il plugin è stata aggiornata l'applet di disegno, ora sono disponibili ulteriori opzioni per disegnare organigrammi più compatti (ad esempio invertendo l'orientamento dell'ultimo livello di foglie).

Utilizzo del plugin

Genera degli organigrammi utilizzando l'applet OrgApp.

Sintassi

<orgapp attributo="valore" attributo="valore" ...>
 Definizione organigramma
</orgapp>

I possibili valori, tutti opzioniali, degli attributi sono:

Nome	Descrizione
width	Larghezza organigramma
height	Altezza organigramma
name	Nome da dare all'applet dell'applet
code	Classe principale dell'applet
archive	Locazione (URL) dell'archivio dell'applet
target	Valore predefinito dell'attributo target dei link
type	Tipo di organigramma (0=SOF), vedere OrgApp per ulteriori dettagli
url	Locazione (URL) della definizione dell'organigramma

L'organigramma può essere definito sia direttamente nella pagina Wiki, sia utilizzando un file esterno. Nel primo caso è sufficiente inserire la definizione all'interno del tag orgapp, nel secondo caso occorre valorizzare l'attributo url con l'URL da cui reperire la definizione.

Esempi

Il codice seguente mostra come definire un organigramma direttamente nella pagina wiki:

<orgapp>
 <organigram>
  <unit name="eIrOcA" >
   <unit name="eNrIcO" />
   <unit name="sImOnA" />
  </unit>
 </organigram>
</orgapp>

genera il seguente risultato:

Il codice seguente mostra come disegnare un organigramma definito in un file esterno cambiandone la larghezza predefinita dall'amministratore:

<orgapp width="100%" url="/apps/orgapp/data2.sof"></orgapp>

genera il seguente risultato:

Istallazione

Scaricare e installare il plugin tramite il Plugin Manager usando il seguente http://www.eiroca.net/apps/dokuwiki/dokuwiki-plugin-orgapp.zip. Oppure installarlo manualmente (vedere plugins) usando il codice, sempre aggiornato, che si ottiene dalla sezione releases di github.

Amministrazione

I valori di default della generazione dell'organigramma possono essere cambiati da pannello di controllo.

E' consigliabile, ma non necessario, spostare il file OrgApplet.jar in una cartella del Web dedicata a servire risorse statiche e modificare la relativa URL nel campo Archive del pannello di amministrazione.

ATTENZIONE se l'applet non si carica controllare:

che sul PC sia stato installato correttamente un runtime java (versione 6 preferibile)
che il parametro Archive contenga l'URL corretto del file OrgApplet.jar
di non aver attivato la funzionalità nice URL di dokuwiki. Se si vuole utilizzare tale funzionalità occorre spostare il file OrgApplet.jar in una cartella di risorse statiche esterna alla parte di sito gestita da dokuwiki.

Versioni

Versione 19.02

Supporto a dokuwiki “Greebo”
Supporto a PHP 7.x

Version 2013/06/29

Aggiornata con l'ultima versione dell'applet

Versione 2011/02/03

Aggiunto bottone nella toolbar di editing
Supporto a DokuWiki “Anteater”

Versione 2010/04/19

Prima versione

Licenza & Copyright

Insieme al programma ci dovrebbe essere una copia della GNU General Public License, se no, scaricala da http://www.gnu.org/licenses/.

DokuWiki, Organigrammi, PHP

Dokuwiki Plugin - barcode

Anonymous (anonymous@undisclosed.example.com) — 2019-02-24T16:15:57+0000

Dokuwiki Plugin - barcode

Plugin Dokuwiki per creare codici a barre 2D con diversi providers.

Al plugin è stato aggiunto il supporto al plugin translation. Se il plugin è installato viene utilizzato per determinare la lingua con cui vengono scritto i messaggi.

Utilizzo del plugin

Genera dei barcode 2D utilizzando:

Il layout del codice a barre può essre definito con dei fogli di stile CSS.

Sintassi

~~BARCODE~attributo1=valore1~attributo2=valore2~~

I possibili valori, opzioniali, di attributo sono:

Nome	Descrizione
id	id da assegnare al tag img del barcode
class	class da assegnare al tag img, i valori possibili sono:
	barcode_left → per allineare a sinistra il barcode
	barcode_right → per allineare a destra il barcode
	barcode_center → per centrare il barcode
mode	Valido solo per I-nigma, 0 genera di codici QR, 1 dei barcode DataMatrix
size	Dimensione del barcode, ammessi: S, M, L, XL

Oltre ai precedenti e necessario specificare al massimo uno dei seguenti per descrivere il contenuto del barcode:

Nome	Descrizione
url	il barcode è un URL, es. url=http://www.eiroca.net
sms	il barcode è un SMS, es. sms=+391234567890=A Message
tel	il barcode è un numero di telefono, es. tel=+391234567890
contact	il barcode è un contatto, es. contact=Name=+123432324=my@address.com
text	il barcode è un testo, es. text=MAILTO:my@address.com

Se questo manca attributo viene generato un barcode che punta alla pagina che lo contiene.

Usando id e class è possibile controllare, via CSS, il comportamento dell'immagine.

Possono inoltre essere settati eventuali attributi specifici dei singoli provider, ad esempio:

Nome	Descrizione
caption	Valido solo per I-nigma, titolo da usare in basso al barcode
bgcolor	Valido solo per QRServer, colore di sfondo del barcode

Vedere il sito del singolo provider la documentazione specifica.

Esempi

Si ottengono con il seguente codice:

~~BARCODE~class=barcode_left~url=http://www.eiroca.net/dokuwiki~size=S~~
~~BARCODE~class=barcode_right~url=http://www.eiroca.net/dokuwiki~size=S~~
~~BARCODE~class=barcode_center~size=M~~

Istallazione

Scaricare e installare il plugin tramite il Plugin Manager usando il seguente http://www.eiroca.net/apps/dokuwiki/dokuwiki-plugin-barcode.zip. Oppure installarlo manualmente (vedere plugins) usando il codice, sempre aggiornato, che si ottiene dalla sezione releases di github.

Amministrazione

Tramite il pannello di gestione Plugin è possibile configurare:

Il provider da usare per generare il barcode
Se mostrare un messagio che suggerisce un reader mobile per leggere il barcode

I testi dei messagi puossono essere configurato modificando i file footer.txt presenti nella directory del plugin. Per aggiungere eventuali nuove lingue non ancora presenti occorre creare un file footer_XX.txt dove XX è il codice della nuova lingua. La lingua viene determinata tramite l'utilizzo del plugin translation, se non è installato tramite la lingua di default della wiki ($conf['lang']).

Versioni

Versione 19.02

Supporto a dokuwiki “Greebo”
Supporto a PHP 7.x

Versione 2013/06/29

Aggiunto il supporto al plugin translation

Versione 2011/02/03

Aggiunto bottone nella toolbar di editing
Supporto a DokuWiki “Anteater”

Versione 2010/04/20

Il footer è traducibile in più lingue
Nuova architettura di gestione dei provider
Nuovo provider (QRserver)
Semplificazione amministrazione

Versione 2010/01/20

Semplificazione sintassi per generare un barcode che punta alla pagina che lo contiene
Rimozione di codice superfluo

Versione 2010/01/05

Prima versione

Licenza & Copyright

Insieme al programma ci dovrebbe essere una copia della GNU General Public License, se no, scaricala da http://www.gnu.org/licenses/.

DokuWiki, barcode, QRCode, PHP