Extension:Survey/it

Manuale sulle Estensioni MediaWiki

Survey Stato della release: sperimentale
Implementazione	Pagina speciale , API , Interfaccia utente, Ajax
Descrizione	Survey è un'estensione MediaWiki che consente agli amministratori di definire rilevamenti che possono poi essere mostrati a gruppi specifici di utenti.
Autore(i)	Jeroen De Dauw
Mantenuta da	WikiTeq team
Versione	0.3.0 alpha (2014-04-02)
Politica di compatibilità	Per ogni versione di MediaWiki LTS (supporto a lungo termine) c'è un branch corrispondente nell'estensione
MediaWiki	1.39
PHP	7.0+
Modifiche al Database	Sì
Licenza	GNU General Public License 2.0 or later
Scaricare	Download extension Git [?]: Download Git master browse repository (Phabricator · GitHub) commit history repository contributors (GitHub) code review README
Parametri $wgSurveySettings
Diritti aggiunti surveyadmin surveysubmit
Hook usati LoadExtensionSchemaUpdates UnitTestsList ParserFirstCallInit ArticleViewHeader AdminLinks
Quarterly downloads	4 (Ranked 134th)
Traduci l'estensione Survey se è disponibile su translatewiki.net
Problemi	Compiti aperti · Riportare un bug

L'estensione Survey consente agli amministratori di definire rilevamenti che possono poi essere mostrati a gruppi specifici di utenti. Non funziona su nessuna versione attualmente supportata di MediaWiki.

Feature overview

• I rilevamenti vengono mostrati agli utenti wiki utilizzando un simpatico modulo pop-up.
• I rilevamenti possono essere creati e modificati tramite un pannello di amministrazione (Speciale:Rilevamenti).
• I rilevamenti possono essere mostrati a specifiche tipologie di utenti (loggati, anonimi, editori, confermati,…)

• Surveys can be shown for a specified percentage of users, and only after a certain amount of page views.

• Le domande del sondaggio possono avere diversi tipi di input, alcuni dei quali consentono risposte restrittive.

• Surveys can be tested by admins via Special:TakeSurvey without them being live on the wiki.

• Summaries of survey submissions can be found on Special:SurveyStats.

• The survey submission data (i.e. user answers) can be exported via an API.

Installation

• Download and move the extracted Survey folder to your extensions/ directory.
  Developers and code contributors should install the extension from Git instead, using:cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/Survey
• Aggiungi il seguente codice al tuo $LocalSettings (preferibilmente alla fine):

  wfLoadExtension( 'Survey' );
  

• Esegui lo script di aggiornamento, che creerà automaticamente nel database le tavole necessarie a questa estensione.
• Configure as required.
•  Done – Naviga in Special:Version nella tua wiki per verificare che l'estensione sia stata installata correttamente.

Configuration

Configuration of Survey is done by assigning to $egSurveySettings in your LocalSettings.php file. Le opzioni sono elencate di seguito e il loro valore predefinito è impostato nel File delle impostazioni del sondaggio.

NON dovresti modificare il file delle impostazioni, ma puoi dargli un'occhiata per avere un'idea di come utilizzare le impostazioni, nel caso in cui le descrizioni seguenti non siano sufficienti.

Example of how to change a setting:

$egSurveySettings['defaultEnabled'] = true;

Impostazioni disponibili:

Name	Type	Impostazione predefinita	Description
defaultEnabled	boolean	false	If surveys should be enabled by default
defaultUserType	Survey::$USER_	Survey::$USER_ALL	Il tipo di utenti predefinito a cui è mostrato un sondaggio
defaultNamespaces	array	array()	The default namespaces in which surveys should be shown. Empty list for no namespace restrictions
defaultRatio	integer	100	La percentuale predefinita di utenti a cui le indagini dovrebbero essere mostrate
defaultExpiry	integer	60 * 60 * 24 * 30	The default expiry of cookies used to track survey completion of users, in seconds
defaultMinPages	integer	0	The default minimum amount of pages users should visit before getting a survey
JSDebug	boolean	false	Indicates if JavaScript debugging should be on or not. Should be false on production environments.

Uso

This section is targeted at site admins that want to set up and manage surveys. For users the process of taking a survey should be self-explanatory.

Creazione e modifica dei sondaggi

Surveys can be created, edited and removed in Special:Surveys by people with the survey admin right, by default only sysops.

Sondaggi di test

Surveys can be tested by clicking the survey name or "take this survey" in the admin UI. This takes you to Special:TakeSurvey, which can be used to test survey submissions. You will be able to submit as many times as you want. Only people with the survey admin right can access this page.

Distribuzione dei sondaggi

Once a survey is enabled, it gets deployed wiki-wide for all users matching the user criterion. These users will then need to visit the minimum amount of pages before the survey gets activated, at which point a lottery is done, making sure only the specified percentage of these users gets the survey.

If you want to instead deploy a survey on one or more individual pages, you can embed the ‎<survey> tag in each one. It is called in the following way:

<survey id="" ratio="" expiry="" min-pages="" />

The ID should match the survey's ID, which is the string that shows up after "Special:TakeSurvey/". The other attributes each correspond to settings found in Special:EditSurvey.

Do note that using the survey tag is an experimental feature which might not work properly in all situations.

Keeping track of surveys

A summary of survey results can be found on Special:SurveyStats, linked from the admin UI. This is only accessible by people with the survey admin right.

Exporting data via the API

Survey allows you to export surveys and submission data via the MediaWiki API using these 3 API modules:

• ApiQuerySurveys — get the surveys matching the provided conditions — api.php?action=query&list=surveys&suids=4|2

• ApiQuerySurveySubmissions — get the submissions for a survey — api.php?action=query&list=surveysubmissions&qsid=42

• ApiQuerySurveyAnswers — get the answers (there is 1 for each field in a submission) — api.php?action=query&list=surveyanswers&qaid=42

These modules can only be used to query data by people that have the surveyadmin right. Full documentation for these API modules can be found at api.php on your wiki.

Version

Version 0.3.0 alpha is the attempt to bring this extension to compatibility with MediaWiki 1.23+.

The release notes in Git only cover up to version 2.0 at this point.

Internationalization

Survey is fully internationalized. Translation of Survey messages is done through translatewiki.net. The translation for this extension can be found here. To add language values or change existing ones, you should create an account on translatewiki.net, then request permission from the administrators to translate a certain language or languages on this page (this is a very simple process). Once you have permission for a given language, you can log in and add or edit whatever messages you want to in that language.

Authors

Survey has been written by Jeroen De Dauw as WikiWorks consultant for the IEEE.

Screenshots

• 
  Special:Surveys listing the available surveys
• 
  Special:EditSurvey is the editing interface for surveys
• 
  Surveys are displayed to users as a pop-up screen, and can be tested on Special:TakeSurvey
• 
  Summaries of survey submissions can be found on Special:SurveyStats

See also