Documentation du code de SPIP et de ses plugins

LangOnet

verifier_items.php

Table of Contents

Constants

_LANGONET_DEBUG  = \false
_LANGONET_ITEM_HTML_BALISE  = '%<:(?:([a-z0-9_-]+):)?((?:[^:<>|{]+(?:<[^>]*>)?)*)([^:>]*):/?>%sm'
_LANGONET_ITEM_HTML_FILTRE_T  = "%#[A-Z_0-9]+{(?:([a-z0-9_-]+):)([a-z0-9_]+)}((?:\\s*\\|\\w+(?:{[^.<>]*})?)*)\\s*\\|_T%Usm"
_LANGONET_ITEM_HTML_PLURIEL_ARG1  = "%\\|singulier_ou_pluriel{(?:[\\s]*(?:(?:#[A-Z_0-9]+{)*)(?:([a-z0-9_-]+):)?([a-z0-9_]*))([^,]*),%sm"
_LANGONET_ITEM_HTML_PLURIEL_ARG2  = "%\\|singulier_ou_pluriel{[^,]*,(?:[\\s]*(?:(?:#[A-Z_0-9]+{)*)(?:([a-z0-9_-]+):)([a-z0-9_]+))([^,\n]*)[,\n]%sm"
_LANGONET_ITEM_HTML_SET  = "%#SET{[^,]+,\\s*(?:([a-z0-9_-]+):)([a-z0-9_]+)}%Usm"
_LANGONET_ITEM_PAQUETXML  = ",titre=['\"](?:([a-z0-9_-]+):)?([a-z0-9_]+)['\"],ism"
_LANGONET_ITEM_PHP_OBJET_A  = '%=>\\s*\'(?:([a-z0-9_]+):)([^\']*)\'\\s*([^,\\n]*)[,\\n]%Sm'
_LANGONET_ITEM_PHP_OBJET_G  = '%=>\\s*"(?:([a-z0-9_]+):)([^\\/"]*)"%Sm'
_LANGONET_ITEM_PHP_SAISIE  = '%=>\\s*[\'"]<:(?:([a-z0-9_-]+):)?((?:[\\w]+(?:<[^>]*>)?)*)([^:]*):>[\'"]%sm'
_LANGONET_ITEM_PHP_TRAD_A  = '%_[TU]\\s*[(]\\s*\'(?:([a-z0-9_]+):)?([^\']*)\'\\s*([^.,)]*[^)]*)%Sm'
_LANGONET_ITEM_PHP_TRAD_G  = '%_[TU]\\s*[(]\\s*"(?:([a-z0-9_]+):)?([^"]*)"\\s*([^.,)]*[^)]*)%Sm'
_LANGONET_ITEM_PLUGINXML  = ",<titre>\\s*(?:([a-z0-9_-]+):)?([a-z0-9_]+)\\s*</titre>,ism"
_LANGONET_ITEM_XML_ATTRIBUT  = ",\\w+=['\"](?:([a-z0-9_-]+):)([a-z0-9_]+)['\"],ism"
_LANGONET_ITEM_XML_CONTENU  = ",<\\w+>\\s*(?:<:)*(?:([a-z0-9_-]+):)([a-z0-9_]+)(?::>)*\\s*</\\w+>,ism"
_LANGONET_ITEM_YAML  = ',<:(?:([a-z0-9_-]+):)?([a-z0-9_]+):>,sm'

Functions

inc_verifier_items()  : array<string|int, mixed>
Verification des items de langue non définis ou obsolètes.
collecter_occurrences()  : array<string|int, mixed>
Cherche l'ensemble des occurrences d'utilisation d'items de langue dans la liste des fichiers fournie.
identifier_type_fichier()  : string
Identifie le type de fichier dans lequel chercher les occurrences d'utilisation d'items de langue.
rechercher_ligne()  : mixed
memoriser_occurrence()  : array<string|int, mixed>
Memorise selon une structure prédéfinie chaque occurrence d'utilisation d'un item.
extraire_arguments()  : array<string|int, mixed>
Gérer les arguments.
reperer_items_non_utilises()  : array<string|int, mixed>
Détection des items de langue obsolètes d'un module.
reperer_items_non_definis()  : array<string|int, mixed>
Détection des items de langue utilises mais apparamment non definis.

Constants

_LANGONET_ITEM_HTML_BALISE

public mixed _LANGONET_ITEM_HTML_BALISE = '%<:(?:([a-z0-9_-]+):)?((?:[^:<>|{]+(?:<[^>]*>)?)*)([^:>]*):/?>%sm'

_LANGONET_ITEM_HTML_FILTRE_T

public mixed _LANGONET_ITEM_HTML_FILTRE_T = "%#[A-Z_0-9]+{(?:([a-z0-9_-]+):)([a-z0-9_]+)}((?:\\s*\\|\\w+(?:{[^.<>]*})?)*)\\s*\\|_T%Usm"

_LANGONET_ITEM_HTML_PLURIEL_ARG1

public mixed _LANGONET_ITEM_HTML_PLURIEL_ARG1 = "%\\|singulier_ou_pluriel{(?:[\\s]*(?:(?:#[A-Z_0-9]+{)*)(?:([a-z0-9_-]+):)?([a-z0-9_]*))([^,]*),%sm"

_LANGONET_ITEM_HTML_PLURIEL_ARG2

public mixed _LANGONET_ITEM_HTML_PLURIEL_ARG2 = "%\\|singulier_ou_pluriel{[^,]*,(?:[\\s]*(?:(?:#[A-Z_0-9]+{)*)(?:([a-z0-9_-]+):)([a-z0-9_]+))([^,\n]*)[,\n]%sm"

_LANGONET_ITEM_HTML_SET

public mixed _LANGONET_ITEM_HTML_SET = "%#SET{[^,]+,\\s*(?:([a-z0-9_-]+):)([a-z0-9_]+)}%Usm"

_LANGONET_ITEM_PAQUETXML

public mixed _LANGONET_ITEM_PAQUETXML = ",titre=['\"](?:([a-z0-9_-]+):)?([a-z0-9_]+)['\"],ism"

_LANGONET_ITEM_PHP_OBJET_A

public mixed _LANGONET_ITEM_PHP_OBJET_A = '%=>\\s*\'(?:([a-z0-9_]+):)([^\']*)\'\\s*([^,\\n]*)[,\\n]%Sm'

_LANGONET_ITEM_PHP_OBJET_G

public mixed _LANGONET_ITEM_PHP_OBJET_G = '%=>\\s*"(?:([a-z0-9_]+):)([^\\/"]*)"%Sm'

_LANGONET_ITEM_PHP_SAISIE

public mixed _LANGONET_ITEM_PHP_SAISIE = '%=>\\s*[\'"]<:(?:([a-z0-9_-]+):)?((?:[\\w]+(?:<[^>]*>)?)*)([^:]*):>[\'"]%sm'

_LANGONET_ITEM_PHP_TRAD_A

public mixed _LANGONET_ITEM_PHP_TRAD_A = '%_[TU]\\s*[(]\\s*\'(?:([a-z0-9_]+):)?([^\']*)\'\\s*([^.,)]*[^)]*)%Sm'

_LANGONET_ITEM_PHP_TRAD_G

public mixed _LANGONET_ITEM_PHP_TRAD_G = '%_[TU]\\s*[(]\\s*"(?:([a-z0-9_]+):)?([^"]*)"\\s*([^.,)]*[^)]*)%Sm'

_LANGONET_ITEM_PLUGINXML

public mixed _LANGONET_ITEM_PLUGINXML = ",<titre>\\s*(?:([a-z0-9_-]+):)?([a-z0-9_]+)\\s*</titre>,ism"

_LANGONET_ITEM_XML_ATTRIBUT

public mixed _LANGONET_ITEM_XML_ATTRIBUT = ",\\w+=['\"](?:([a-z0-9_-]+):)([a-z0-9_]+)['\"],ism"

_LANGONET_ITEM_XML_CONTENU

public mixed _LANGONET_ITEM_XML_CONTENU = ",<\\w+>\\s*(?:<:)*(?:([a-z0-9_-]+):)([a-z0-9_]+)(?::>)*\\s*</\\w+>,ism"

_LANGONET_ITEM_YAML

public mixed _LANGONET_ITEM_YAML = ',<:(?:([a-z0-9_-]+):)?([a-z0-9_]+):>,sm'

Functions

inc_verifier_items()

Verification des items de langue non définis ou obsolètes.

inc_verifier_items(string $module, string $langue, string $ou_langue, array<string|int, mixed> $ou_fichiers, string $verification) : array<string|int, mixed>
Parameters
$module : string

prefixe du fichier de langue

$langue : string

index du nom de langue

$ou_langue : string

chemin vers le fichier de langue à vérifier

$ou_fichiers : array<string|int, mixed>

tableau des racines d'arborescence à vérifier

$verification : string

type de verification à effectuer

Return values
array<string|int, mixed>

collecter_occurrences()

Cherche l'ensemble des occurrences d'utilisation d'items de langue dans la liste des fichiers fournie.

collecter_occurrences( $fichiers) : array<string|int, mixed>

Cette recherche se fait ligne par ligne, ce qui ne permet pas de trouver les items sur plusieurs lignes.

Parameters
$fichiers :
Return values
array<string|int, mixed>

identifier_type_fichier()

Identifie le type de fichier dans lequel chercher les occurrences d'utilisation d'items de langue.

identifier_type_fichier(string $fichier) : string
Parameters
$fichier : string

Chemin complet du fichier à scanner

Return values
string

Extension du fichier parmi 'xml', 'yaml', 'html' et 'php' ou le nom du fichier de description du plugin 'paquet.xml' ou 'plugin.xml'.

rechercher_ligne()

rechercher_ligne(mixed $offset, mixed $lignes) : mixed
Parameters
$offset : mixed
$lignes : mixed

memoriser_occurrence()

Memorise selon une structure prédéfinie chaque occurrence d'utilisation d'un item.

memoriser_occurrence(array<string|int, mixed> $utilisations, array<string|int, mixed> $occurrence, string $regexp) : array<string|int, mixed>

Cette fonction analyse au passage si l'item est dynamique ou pas (_T avec $ ou concatenation).

Parameters
$utilisations : array<string|int, mixed>

Tableau des occurrences d'utilisation des items de langues construit à chaque appel de la fonction.

$occurrence : array<string|int, mixed>

Tableau associatif définissant l'occurrence d'utilisation en cours de mémorisation.

$regexp : string

Expression régulière utilisée pour trouver l'occurrence d'utilisation en cours de mémorisation.

Return values
array<string|int, mixed>

Le tableau des occurrences mis à jour avec l'occurrence passée en argument

extraire_arguments()

Gérer les arguments.

extraire_arguments(string $raccourci_regexp) : array<string|int, mixed>

La RegExp utilisee ci-dessous est defini dans phraser_html ainsi: define('NOM_DE_BOUCLE', "[0-9]+|[-][-.a-zA-Z0-9]"); define('NOM_DE_CHAMP', "#((" . NOM_DE_BOUCLE . "):)?(([A-F][G-Z_][A-Z_0-9]*)|[A-Z_]+)(*{0,2})");

Parameters
$raccourci_regexp : string
Return values
array<string|int, mixed>

reperer_items_non_utilises()

Détection des items de langue obsolètes d'un module.

reperer_items_non_utilises(array<string|int, mixed> $utilisations, string $module, array<string|int, mixed> $items_module) : array<string|int, mixed>

Cette fonction renvoie un tableau composé des items obsolètes et des items potentiellement obsolètes.

Parameters
$utilisations : array<string|int, mixed>

Tableau des occurrences d'utilisation d'items de langue dans le code de l'arborescence choisie.

$module : string

Nom du module de langue en cours de vérification.

$items_module : array<string|int, mixed>

Liste des items de langues contenus dans le module de langue en cours de vérification. L'index est le raccourci, la valeur la traduction brute.

Return values
array<string|int, mixed>

Tableau des items obsolètes ou potentiellement obsolètes. Ce tableau associatif possède une structure à deux index :

  • 'occurrences_non' : liste des items obsolètes;
  • 'occurrences_non_mais' : liste des items a priori obsolètes pour le module vérifié mais utilisés avec un autre module;
  • 'occurrences_peut_etre' : liste des items potentiellement obsolètes (contexte d'utilisation dynamique).

reperer_items_non_definis()

Détection des items de langue utilises mais apparamment non definis.

reperer_items_non_definis(array<string|int, mixed> $utilisations, string $module[, array<string|int, mixed> $items_module = array() ][, array<string|int, mixed> $fichiers_langue = array() ]) : array<string|int, mixed>

Cette fonction renvoie un tableau composé des items manquants et des items potentiellement manquants.

Parameters
$utilisations : array<string|int, mixed>

Tableau des occurrences d'utilisation d'items de langue dans le code de l'arborescence choisie.

$module : string

Nom du module de langue en cours de vérification.

$items_module : array<string|int, mixed> = array()

Liste des items de langues contenus dans le module de langue en cours de vérification. L'index est le raccourci, la valeur la traduction brute.

$fichiers_langue : array<string|int, mixed> = array()

Liste des fichiers de langue 'fr' présent sur site et dans lesquels il est possible de trouver certains items de langue.

Return values
array<string|int, mixed>

        
On this page

Search results