MediaWiki/LocalSettings.php: differenze tra le versioni

Wikibooks, manuali e libri di testo liberi.
Contenuto cancellato Contenuto aggiunto
Riga 198: Riga 198:
</pre>
</pre>


(''Potete scaricare da [http://www.naturpedia.org/download/DefaultSettingsURL.zip qui] il nostro file '''DefaultSettings.php''', zippato, della v.1.14 del [[mediawiki|software]]; ma state attenti a conservarne sempre una copia dell'Originale perchè, questo file, è quello più importante di tutti, per il [[wiki]]! Per usarlo, rinominatelo al posto del vostro.'')
(''Potete scaricare da [http://www.naturpedia.org/download/DefaultSettingsURL.zip qui] il nostro file '''DefaultSettings.php''', zippato, della v.1.14 del [[mediawiki|software]]; ma state attenti a conservarne sempre una copia dell'Originale perchè, questo file, è quello più importante di tutti, per il [[:w:wiki|wiki]]! Per usarlo, rinominatelo al posto del vostro.'')


* Quest'altra, vi consente invece di fare in modo che negli articoli, ad un link corrispondente ad un''''immagine esterna''', venga '''visualizzata''' l'immagine di provenienza sul vostro wiki sebbene essa non sia stata caricata sul vostro server. Ma '''questa, va settata sul ''LocalSettings''''':
* Quest'altra, vi consente invece di fare in modo che negli articoli, ad un link corrispondente ad un''''immagine esterna''', venga '''visualizzata''' l'immagine di provenienza sul vostro wiki sebbene essa non sia stata caricata sul vostro server. Ma '''questa, va settata sul ''LocalSettings''''':

Versione delle 22:10, 24 gen 2012

Template:Manuale MediaWiki Il file LocalSettings.php, è quello che vi consente d'impostare i permessi, le estensioni, e altri criteri del vostro wiki; deve trovarsi nella root principale, dove avrete installato il vostro wiki (all'inizio si trova sotto la cartella 'config'; però, appena dopo l'installazione, vi viene detto subito di spostarlo in quella principale e suggerito di cancellare la cartella.)

Le "Variabili" di settaggio

Una lista completa di tutte le sue "variabili" di settaggio, la trovate su Mediawiki, a quest'indirizzo:


In cui è opportuno, dare uno sguardo particolare alla sezione "permessi Utenti":

E a quella di "Jobs" (riferito, al lavoro del "server")


Ciascuna di queste "variabili" è un comando che permette di "settare", ossia, configurare, una specifica funzione del votro wiki.

Non è necessario chiaro usarle tutte (se non le modificate e/o create nel LocalSettings, rimangono comunque settate nei loro valori di "default" nel file DefaultSettings.php, sotto /includes/);

Alcune potrebbero funzionare al meglio tuttavia, soltanto dopo aver installato specifiche estensioni. Vediamo prima queste, quindi.


Nota: Tutti i parametri, per essere disattivati, possono essere semplicemente fatti seguire dal simbolo #, anzichè cambire il loro valore da true a false, e viceversa: per attivare qualcosa, cancellate semplicemente questo simbolo posto all'inizio. Questo vale anche per le stringhe delle estensioni, come vedremo.

Se vedete due o più simbolini, nelle nostre descrizioni e sul nostro file che vi diamo da scaricare, significa: che ne sconsigliamo caldamente l'utilizzo ai non esperti.

Configurare le Estensioni

Template:Vedi anche2 Una volta copiate le cartelle delle estensioni (e/o i singoli file php)

nella cartella omonima del vostro wiki, non vi resta che attivarle

andando a modificare il file LocalSettings.php

Questi che vi forniamo qui di seguito noi, sono i parametri che dovrete aggiungere per le estensioni che vi abbiamo fornito in questo nostro Manuale, e che consideriamo le più importanti ed utili. Vi alleghiamo al fondo anche un modello di file "LocalSettings.php" della versione 1.14 del software. (Se volete usarlo, rinominatelo pulito).

Attivarle dal nostro file

Template:Vedi anche2 Attivarle dal nostro file infatti (vedi codice sotto) vi sarà così più semplice, che star lì a cercarle, in quanto abbiamo già scelto tutte quelle basiche.

Non dovrete far altro, cioè, che togliere il simbolino # all'inizio di quelle che v'interessano e rimetterlo, poi, quando vorrete di nuovo renderle inattive. Ovviamente, dovrete aver prima caricato via Ftp anche le relative cartelle, come già spiegato nel capitolo precedente.

Nota: alcune ve le forniamo già attive, quelle più importanti ed utili; se volete disattivarle, poneteci semplicemente il simbolino # davanti.

Code1:

====
PARAMETRI DA AGGIUNGERE E/O SPECIFICARE nel LocalSetting:
====

Ecco il codice da aggiungere (clicca sul link): Template:Vai2


L'installazione

L'installazione di un'estensione, di solito, consiste unicamente di due passaggi:

  1. Si copia via Ftp la cartella e/o il file .php dell'estensione dell'estensione stessa, nell'omonima sul vostro server (la cartella si chiama 'Estensions', e viene a trovarsi nella root dove avrete installato il vostro wiki)
  2. Si attiva poi l'Estensione sul file LocalSettings, apponendovi al fondo una stringa:
    • require_once("$IP/extensions/NomeDell'Estensione/NomeDell'Estensione.php"); oppure:
    • require_once("$IP/extensions/NomeDell'Estensione.php");
      a seconda se avete trasferito file o cartella. L'importante è non sbagliare: dovrete infatti qui mettere l'esatto percorso del file .php principale
  3. Un passaggio extra, vi è solo quando dovete creare da voi i file .php perchè non forniti nel download; dovrete allora copiarvi il codice sorgente e salvarlo in un file di testo che rinominerete col nome esatto dell'estensione, terminandolo in .php anzichè .txt


Configurare permessi ed altri parametri del wiki

In questa sezione affrontiamo solo i parametri di base, quelli giusto per avere subito il vostro wiki operativo, cioè. (Una lista esaustiva, in inglese, la trovate ai link che abbiamo già dato sopra al paragrafo Variabili di settaggio).

Attivarli dal nostro file

Potete fare copia incolla dal file che vi diamo.

In questa parte, ricordatevi ovviamente che dovete cambiare i dati di esempio con quelli personali vostri (come il nome del Database, ecc).

Magari, fate copia incolla soltanto delle sezioni che v'interessano.

Code2:

=====
PARAMETRI DA AGGIUNGERE E/O SPECIFICARE nel LocalSetting:
=====

Template:Vai2 Template:Vedi anche2


Permessi

Se volete che il vostro wiki non sia aperto a tutti -ovvero che gli IP anonimi non possano editare e possano farlo solo quelli registrati (loggati)- dovete aggiungere al vostro file LocalSettings.php, questa variabile:

  • $wgGroupPermissions['*']['edit'] = false

assieme a questa, per richiede la conferma dell'indirizzo e.mail per poter editare.

  • $wgEmailConfirmToEdit = true;


Se lo volete ancora più chiuso e fare in modo che solo voi (o comunque i 'sysop') possiate creare Account per le persone che potranno scrivere, aggiungetevi quest'altra:

  • $wgGroupPermissions['*']['createaccount'] = false;


Infine quest'ultima, se non volete gli IP anonimi riescano a leggere il vostro wiki, ma soltanto i loggati.

  • $wgGroupPermissions['*']['read'] = false;

Potete specificare le pagine che gli anonimi possono visualizzare, qui

  • $wgWhitelistRead = array("Pagina principale", 'Speciale:UltimeModifiche' );

(mettete il nome della vostra pagina, al posto di quello di "Pagina principale").


Aggiunta di namespaces
  • $wgExtraNamespaces = array(100 => "Associazione", 101 => "Discussioni_associazione");


Upload e immagini

L'Upload di immagini o altri tipi di file, viene attivato quando:

  • La cartella 'images' è resa "scrivibile" (codice permessi "777");
  • La stringa $wgEnableUploads è abilitata sul LocalSettings.php, ossia messa su true;

Vanno poi specificati i parametri, per i tipi di file che si vuole permettere di far caricare.

Tipi di File

La prossima serie di variabili, permettere l'Upload dei File con le estensioni indicate (cancellate quelle che non v'interessano, o disattivatele ponendo il simbolo # all'inizio);

$wgAllowTitlesInSVG = true;
$wgFileExtensions[] = 'svg';
$wgFileExtensions[] = 'bmp';
$wgFileExtensions[] = 'ogg';
$wgFileExtensions[] = 'flv';
$wgFileExtensions[] = 'swf';
$wgFileExtensions[] = 'mp3';
$wgFileExtensions[] = 'pdf';
$wgFileExtensions[] = 'doc';
  • Specificate (sempre nel LocalSettings.php) i tipi di file che sono permessi uploadare; con le variabili appena date sopra, oppure, con questa stringa (non tutt'e due):
$wgFileExtensions = array( 'png', 'gif', 'jpg', 'jpeg', 'doc', 'xls', 'pdf' );

al cui interno metterete appunto, i tipi di file (come da esempio).

Potete anche aggiungere semplicemente quest'altra:

$wgStrictFileExtensions = false;

che permette ai principali tipi di file di essere uploadati, senza bisogno di specificare quali.

  • Attivare invece la seguente variabile, se si vuole che nell'Upload appaiano i Campi: "Fonte", e "Dettagli sul Copyright".
$wgUseCopyrightUpload = true;
  • Infine, di default l'Upload è permesso solo agli Utenti loggati; per cambiare questa situazione, fate riferimento ai seguenti permessi che ora andiamo a spiegare (da aggiungere sempre nel file LocalSettings.php).

Permessi per l'Upload

  • Attivando questo parametro, si fa visualizzare sulla barra laterale l'opzione upload anche ai non-loggati (per attivarlo, però, fare riferimento alla prossima stringa)
$wgEnableUploads = true;
  • Se volete che anche gli utenti anonimi (non loggati) possano uploadare files:
$wgGroupPermissions['*']['upload'] = true;
  • La seguente stringa, chiude il permesso di Upload agli Utenti (semplici ip anonimi, o anche loggati):
      $wgGroupPermissions['user']['upload'] = false;
  • Quest'altra, crea invece un gruppo speciale, chiamato "uploadaccess", e permette solo ai membri di questo gruppo l'upload:
      $wgGroupPermissions['uploadaccess']['upload'] = true;
  • La prossima, permette l'Upload solo agli Utenti "autoconfirmed" (cioè, "autoconfermati" tramite mail):
      $wgGroupPermissions['autoconfirmed']['upload'] = true;

Upload diretto da URL

  • Potete permettere agli Utenti l'Upload diretto da un URL con la seguente stringa, da settare però questa volta nel file DefaultSettings.php, che trovate dentro la cartella/includes/. La stringa esiste già, ma di default è settata su: false. Voi mettetela su true, come da esempio:
$wgAllowCopyUploads = true

(Potete scaricare da qui il nostro file DefaultSettings.php, zippato, della v.1.14 del software; ma state attenti a conservarne sempre una copia dell'Originale perchè, questo file, è quello più importante di tutti, per il wiki! Per usarlo, rinominatelo al posto del vostro.)

  • Quest'altra, vi consente invece di fare in modo che negli articoli, ad un link corrispondente ad un'immagine esterna, venga visualizzata l'immagine di provenienza sul vostro wiki sebbene essa non sia stata caricata sul vostro server. Ma questa, va settata sul LocalSettings:
$wgAllowExternalImages = true; 

Collegamento "Carica su Commons"

Per approfondire, vedi Manuale MediaWiki/Barra Laterale#Collegamento_di_.22Carica_su_Commons.22.
  • Questa seconda serie di stringhe serve a far visualizzare le immagini da meta.commons, si aggiunge sempre al file LocalSettings.
$wgForeignFileRepos[] = array(
   'class'                   => 'ForeignAPIRepo',
   'name'                    => 'shared',
   'apibase'                 => 'http://commons.wikimedia.org/w/api.php',
   'fetchDescription'        => true, // Optional
   'descriptionCacheExpiry'  => 43200, // 12 ore, opzionale (valori in secondi)
   'apiThumbCacheExpiry'     => 43200, // 12 ore, opzionale, ma richiesto per la cache di thumb locale
);

Si possono anche aggiungere "altri siti" diversi da commons.

Per approfondire, vedi Manuale MediaWiki/Barra Laterale#Come_aggiungere_un_diverso_.22Contenitore_d.27immagini.22_esterno.

Per esempio, per le immagini da it.wiki, attivate:

$wgForeignFileRepos[] = array(
   'class'            => 'ForeignAPIRepo',
   'name'             => 'sharedwp',
   'apibase'          => 'http://it.wikipedia.org/w/api.php',
   'fetchDescription' => true, // Optional
   'descriptionCacheExpiry'  => 43200, // 12 ore, opzionale (valori in secondi)
   'apiThumbCacheExpiry'     => 43200, // 12 ore, opzionale, ma richiesto per la cache di thumb locale
);

Per mettere poi il collegamento sulla Barra Laterale sinistra, si aggiunge invece quest'altro pezzo di codice nella pagina MediaWiki:Monobook.js del vostro wiki:

/*** Collegamento diretto alla pagina di upload di Commons nel menu di sinistra, da WP:PT */
function linkUploadToCommons()
{
    if (document.getElementById("carrega-para-commons")) return;
    var li_carrega = document.getElementById("t-upload");
    if (!li_carrega) return;
    var afegit = li_carrega.nextSibling;
    var ul_eines = li_carrega.parentNode;
    var li = document.createElement("li");
    li.id = "carrega-para-commons";
    li.innerHTML = '<a href="http://commons.wikimedia.org/wiki/Commons:Upload/it">Carica su Commons</a>';
    if (afegit) ul_eines.insertBefore(li, afegit);
    else ul_eines.appendChild(li);
}

addLoadEvent(linkUploadToCommons);

/*** Fine del collegamento diretto alla pagina di upload di Commons */
Per approfondire, vedi Manuale MediaWiki/Gli Stili.


Link di riferimento

su Wikimedia
Dimensione massima di Upload


Abilitare supporto Math

Per abilitare il supporto math su MediaWiki, si seguono i seguenti passaggi:

LocalSettings

1) Editare il LocalSettings.php e cambiare la linea

$wgUseTeX = false;

a

$wgUseTeX = true;

2) Poi, aggiungere le seguenti linee:

$wgUploadPath = "images";
$wgUploadDirectory = "images";
$wgMathPath = "{$wgUploadPath}/math";
$wgMathDirectory = "{$wgUploadDirectory}/math";
$wgTmpDirectory = "{$wgUploadDirectory}/tmp";

Cartelle

3) Assicurarsi che esistano, se no crearle, le seguenti cartelle:

  • /images/math
  • /images/tmp

nella root dove avete installato il vostro wiki, e dare loro i permessi 755.

4) Infine, fare il download del texvc binary dal seguente link:

e metterlo nella cartella /math, assicurandosi che abbia i permessi 755.

Assistenza hosting

5) E' possibile che si debba anche contattare l'assistenza del proprio servizio di hosting, per abilitare totalmente il servizio. SiteGround provides sembra essere uno dei migliori servizi hosting per MediaWiki, e tali richieste sono evase con facilità.

In alternativa, potete usare l'Estensione Mimetex che vi abbiamo proporzionato in questo nostro Manuale: non richiede alcun tipo di richieste al vostro provider. Template:Vedi anche2


Link di riferimento


Esempi di LocalSettings con traduzione italiana

Vi forniamo qui di seguito degli Esempi di LocalSettings completi (che sarebbero cioè, i due pezzettini uniti assieme che abbiamo visto in questo capitolo separatamente) zippati, tradotti all'italiano e già pronti per essere utilizzati; due dei quali, sono abbinati ai "pacchetti" delle estensioni che vi abbiamo fornito noi nel nostro download. Ricordate che stiamo fornendovi di base quello relativo alla versione 1.14 del software. E che, comunque, nel caso aveste un'altra versione, il "pezzo relativo alle estensioni" (il primo affrontato qui) è uguale per tutti, per cui potrete fare semplicemente copia incolla direttamente nel vostro solo di quello (saltando cioè il relativo ai "settaggi" delle variabili), se non vi sentite sicuri.

Template:Vai2

Link