Extension:PageProperties/fr

PageProperties permet aux utilisateurs d'éditer le titre affiché, la langue et le modèle de contenu d'une page; pour associer des propriétés sémantiques aux pages sans avoir à les annoter manuellement (à condition que Semantic MediaWiki soit installé); et de définir des métadonnées SEO$3 pour l'ensemble du wiki ou pour des pages spécifiques.

L'extension ajoute une action au menu supérieur des articles wiki permettant aux utilisateurs autorisés de définir toutes les propriétés d'une page.

Depuis la version 1.2.4, PageProperties dispose d'une interface graphique complète pour la création des propriétés sémantiques, des catégories sémantiques et des formulaires sémantiques basée sur OOUI et sur les emplacements (slots)!

L'extension ajoute un onglet "Modifier la sémantique" à la navigation de la page, une section dans la barre latérale, et un lien vers l'action du menu de la page. La visibilité de chacun d'eux peut être gérée en utilisant les paramètres ci-dessous





Installation

 * Téléchargez et placez le ou les fichier(s) dans un répertoire appelé   de votre dossier.
 * Ajouter le code ci-dessous à la fin de votre LocalSettings.php
 * vous pouvez facultativement exécuter  dans le répertoire des extensions pour  installer les bibliothèques nécessaires à l'annotation JSON-LD dans la page (voir la section ci-dessous pour d'autres informations)
 * ✅ – Allez sur Special:Version de votre wiki pour vérifier que l'extension est bien installée.

Page Properties


Onglet principal
A partir de l'onglet principal, vous pouvez modifier le titre de l'affichage de la page, la langue et le modèle de contenu. Le titre de l'affichage peut être laissé vide pour cacher complètement le titre sans avoir à déclarer d'instructions css.



Fonctionnalités clé :
 * la langue définie est correctement affichée sur la Page d'information
 * le titre de l'affichage est ajouté à la table des propriétés de page pour qu'il puisse être géré de manière autonome par les autres extensions, comme Display Title
 * Catégorie de suivi optionnelle Pages with PageProperties
 * support for html content model and enhanced support for plain text content model (in this case, the font of page content will be set to monospace, and white spaces/new lines will be preserved unless when necessary to fill line boxes)
 * les propriétés sont enregistrées à un emplacement dédié sur la page concernée et peuvent être affichées par l'onglet des propriétés properties dans le menu de la page (Attention : actuellement, le modèle de contenu de l'emplacement est correctement affiché mais uniquement sur MediaWiki 1.38 et supérieur; dans les autres versions, il utilisera le modèle de contenu de l'emplacement principal)

(cet onglet apparaît quand le paramètre  vaut   ou que l'utilisateur possède les droits  )



Onglet SEO
À partir de l'onglet SEO, vous pouvez facilement ajouter des balises méta ou des méta-propriétés à des pages spécifiques ou à l'ensemble du wiki.

Si l'extension Extension:wikiSEO est installée, PageProperties fournira une combobox avec les paramètres autorisés par l'extension, et ils seront gérés en interne par l'extension WikiSEO elle-même sans avoir besoin de les annoter manuellement sur la page.

Notez que la case à cocher appliquer à tout le wiki ne sera affichée que si les propriétés sont liées à la page d'accueil du wiki.



combobox disponible lorsque l'extension wikiSEO est installée



Modifier la sémantique
(cette fonctionnalité n'est disponible que lorsque Semantic MediaWiki est installé)

From the "Edit semantic" tab you can interactively assign semantic forms and single semantic properties to wiki pages without using parser functions and without annotating them manually on the page.

L'initialisation des propriétés sera visible sur SMW FactBox et elles seront correctement gérées par les requêtes d'interrogation.



Voici les deux points d'entrée pour ajouter ou supprimer respectivement des formulaires vers ou de la page, et ajouter ou enlever des propriétés uniques (non liées à un formulaire spécifique) vers ou de l'une des pages. Chaque propriété est associée à un widget d'entrée OOUI et autorise plusieurs champs.

Ceci est un formulaire appliqué une fois sur une page. Le formulaire est composé de propriétés définies à travers la page spéciale Gérer les propriétés (voir ci-dessous) et regroupées ensuite dans un formulaire défini sur la même page. Forms peut aussi être utilisé pour créer de nouveaux articles comme dans l'Extension PageForms (voir aussi le Manuel de Forms).



Les sections associées pour créer des propriétés, des catégories et même des formulaires sont accessibles à partir de l'onglet Modifier la sémantique lui-même, via l'icône suivante (à l'exception de l'onglet Importer la sémantique qui n'est accessible que depuis la page spéciale Gérer les propriétés)



Fonctionnalités clés
 * les formulaires multiples et les propriétés uniques peuvent être ajoutées de manière interactive à n'importe quelle page wiki
 * chaque formulaire peut présenter ses propres catégories par défaut, sa formule du nom de page (uniquement pour les nouvelles pages) et son modèle de contenu. Lorsque les valeurs sont différentes entre elles, une entrée radio est affichée à l'utilisateur pour qu'il sélectionne les valeurs souhaitées
 * un grand ensemble d'entrées natives OOUI est disponible et peut être ajouté à un formulaire via une interface simple
 * Les propriétés et les formulaires peuvent être édités ou créés en toute simplicité, sans quitter l'interface
 * supporte le téléversement de fichiers multiples



Gérer les propriétés
Depuis la page spéciale Gérer les propriétés, vous pouvez créer ou modifier des propriétés sémantiques, des catégories sémantiques et même effectuer un import sémantique basé sur des fichiers csv.





Onglet des propriétés
C'est ici que vous pouvez définir une propriété. Options prises en charge :
 * type de propriété (l'une de celles listées ici)
 * vocabulaire importé (voir ici)
 * champs multiples
 * entrée préférée
 * toutes les options liées aux propriétés sont listées ici



Un grand nombre d'entrées natives Mediawiki et OOUI sont prises en charge, comme :
 * mw.widgets.DateInputWidget
 * mw.widgets.datetime.DateTimeInputWidget
 * mw.widgets.CategoryMultiselectWidget
 * mw.widgets.TitlesMultiselectWidget
 * mw.widgets.UsersMultiselectWidget
 * OO.ui.MultilineTextInputWidget
 * OO.ui.TagMultiselectWidget
 * OO.ui.ComboBoxInputWidget
 * OO.ui.SelectFileWidget
 * Entrée de numéro de téléphone international pour le type de données numéro de téléphone (telephone_number)

et encore plus !



When you delete/rename a property all the pages containing that property will be affected as well, and the property will be either deleted or renamed on all relevant pages, so take into account the following tip!



Onglet des catégories
C'est là que vous pouvez définir une catégorie. Options prises en charge :
 * chaque catégorie peut être associée à n'importe quel vocabulaire importé enregistré sur le wiki.





Onglet des formulaires
C'est ici que vous pouvez définir un formulaire. Options prises en charge :
 * formule du nom de page ou entrée du widget de titre
 * afficher ou masquer les entrées de texte libre
 * default categories
 * default content model

This is where (in the same window) you can assign fields to a form. Fields can be rearranged and through buttons located besides each of them you can access the related property window, and the field window.



This is where you can define the property/field assigned to a form. Supported options: on create only (whether the input should be used only to compose the form pagename formula)
 * required and default values
 * custom label (can override the property label with a localized message)
 * custom help text (can override with a localized message the property description if any)
 * preferred input (can override the same attribute of the related property)
 * option-values for multiple choice inputs retrieved from property declaration, hard-coded values, wikilist or an ask query (see here)
 * mapping-formula - for inputs that are multiple choices, allow you to modify how they are displayed in the form, without modifying the actual property value, similar to mapping template in the PageForms extension.
 * multiple values (can override the same attribute of the related property)



Created forms will be listed in a dedicated section in the sidebar, as follows:





Onglet d'importation
From the "Import" tab you can import in your wiki csv files, mapping their fields to semantic properties defined or to be defined in the wiki. Also large set of csv lists can be incrementally imported and even previewed before the actual import through the interface. A page will be created for each csv entry, with a large set of options in order to define the target pagename, the page content, values separator, defined categories, and more !

Here is where you can upload/drop the cvs file to be imported.



Here is where you can check the consistency of your data and to set/remove the heading.



Here is where you can map the csv fields to semantic properties recorded in the wiki and even to create new properties on the fly.



Here is where you can preview the import, so to avoid or to minimize mistakes: note indeed that by default a single wiki page will be created for each csv entry.





#pagepropertiesform
The  parser function can be used to display multiple forms in any wiki page, each of them composed by multiple forms (handled as form sections). Il suffit de créer un formulaire à travers l'interface comme indiqué ci-dessus, puis utiliser le wikicode suivant pour faire le rendu d'un formulaire composé sur la page.

where "Form a", "Form b" and "Form c" are the names of different forms. After you have placed the forms on an article of your choice, a form submission will either create a new article based on the form's pagename formula or the title entered by the user in the form itself, or will trigger an error in case that an article with the same title already exists. By contrast, in order to edit the semantic properties of the current article, just use the Edit semantic tab. Finally, through this parser function, an arbitrary number of forms can be inserted in any article in the desired position.

#pagepropertiesformbutton
The  parser function can be used to display a link button pointing to a new form rendered in a special page. The new form, as above, can in turn be composed by multiple forms.

where "text" is the button's text, "Form a", "Form b" and "Form c" are the forms to be rendered on the special page, "button-type" is an optional parameter to determine whether the form button will be rendered as button or as text (use the values "button" and "text"), and class is an optional parameter to add to the button link one or more classes.

#pageproperties
The  parser function can be used to easily display the semantic properties associated to a page, using templates, both for the given set of properties, and for each value of a given property (useful when a property contains multiple values, for instance pictures to be rendered in some way)

Example:

(in the second example the parser function will retrieve the value of the semantic property,  , will display the   using the template "Organization logo", and will display such parameters using the template "Organization" (the value of the property Logo is translated using the desired template)

Note: This parser function could be subjected to design changes in the next version!

JSON-LD
JSON-LD (JavaScript Object Notation for Linked Data) is "a method of encoding linked data using JSON" (source: JSON-LD). PageProperties automatically includes the ontology associated with the page, if any, in the following form: { "@context": { "name": "http://xmlns.com/foaf/0.1/name", "homepage": { "@id": "http://xmlns.com/foaf/0.1/workplaceHomepage", "@type": "@id" },   "Person": "http://xmlns.com/foaf/0.1/Person" }, "@id": "https://me.example.com", "@type": "Person", "name": "John Smith", "homepage": "https://www.example.com/" }

This feature is available when PageProperties is used in conjunction with Semantic MediaWiki, and is especially useful, for the purpose of search engine optimization, when the wiki contains pages describing schema.org items, like Person, Book, Organization and more.

Configuration
The extension works at its best when used in conjunction with Semantic MediaWiki, WikiSEO and Display Title. However, none of them are necessary, when used without Semantic MediaWiki the semantic tab will be omitted, when used without WikiSEO meta tags have to be entered without a dropdown, and when used without Display Title it is possible that the alternate page title cannot be used for linking.

Global parameters

(n) true if user has right, otherwise false

(if both  and   are set to , the PageProperties special page will be not accessible from the interface)



Droits et privilèges
The extension creates the following user rights. They can be both included manually in the LocalSettings.php or to be managed through the interface (special page Special:UserRights).

Sysops and bureaucrats are assigned with the complete set of permissions by default.

Rights:

Example configuration:

Groups:



Problèmes connus

 * Subsequent edits of the name of a file through the specif implementation of  do not yet update the name of the published file. This will be fixed on a coming version.
 * rename of properties does not yet reflect on form descriptors
 * if the dedicated slot does contain unregistered properties, they won't be shown in the Edit semantic special page. This could change in future.



Démonstrations et tests
You are welcome to test the extension here: wikienterprise.org



Améliorations récentes

 * and  parser functions (forms can be inserted in any wiki article)
 * native input validation (with regard of the required attribute) for all OOUI inputs
 * dynamic option values for multiple choice input widgets, based on user's entered values, wiki-lists, and ask queries
 * hidden inputs
 * value-formula (keeps track of the original value, to be used for subsequent edits)
 * renaming/deletion of properties through the interface automatically updates all pages and forms with that property, with a notice about the jobs to be executed
 * categories created by the GUI are correctly handled in ask queries
 * optimized loading of required data
 * additional input widgets, namely Rating and ButtonMultiselectWidget

Feuille de route

 * option-inputs with search api and infinite scroll (for long lists)
 * editable input label (done in version 1.2.5c)
 * subitems or subobjects
 * form sections
 * searchable properties in slots and preload content
 * dedicated window for options of each available input, as outlined here (OO.ui.TextInputWidget as an example), consistent across Manage Properties and (Form edit's) Edit field
 * bulk edit
 * additional inputs, like tree and rating (done in version 1.2.5c: rating and multiple toggle buttons)
 * support Extension:Semantic_Interlanguage_Links



Support et bogues
Please post error messages in the Talk page of the extension. Updates will be posted on the Semantic MediaWiki user list and occasionally in the MediaWiki's Wikitech mailing list.

For professional support please use this Contact form (an Extension:CIForms's form)



Voir aussi

 * Extension:Semantic MediaWiki
 * Extension:wikiSEO
 * Extension:MetaMaster
 * Extension:Semantic Meta Tags
 * Extension:AdvancedMeta
 * Extension:ContactManager