Documentation du code de SPIP et de ses plugins

LangOnet

Documentation

Table of Contents

Packages

Application

Constants

_LANGONET_DEBUG  = \false
_LANGONET_DOSSIERS_EXCLUS  = ''
Permet de définir les arborescences à exclure du scan des fichiers de langue.
_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'
_LANGONET_PATTERN_CODE_LANGUE  = '%_(\\w{2,3})(_\\w{2,3})?(_\\w{2,4})?$%im'
_LANGONET_PATTERN_ETAT_ITEM  = '%\\s[\'"]([^\'"]*)[\'"].+[\'"](?:[^\'"]*)[\'"]\\s*,?(?:\\s*#\\s*(NEW|MODIF))?$%Uims'
_LANGONET_PATTERN_FICHIERS_L  = '(?<!/charsets|/lang|/req)(/[^/]*\\.(php))$'
_LANGONET_PATTERN_FICHIERS_LANG  = '_[a-z]{2,3}\\.php$'
_LANGONET_PATTERN_FICHIERS_LANG_FR  = '_fr\\.php$'
_LANGONET_PATTERN_FONCTION_L  = "#\\b_L\\s*[(]\\s*([\"'])((?:\\\\\\1|[^\\1])+)\\1[^)]*\\)#Uims"
_LANGONET_PATTERN_REFERENCE  = '#<traduction[^>]*reference="(.*)">#Uims'
_LANGONET_SIGNATURE_SPIP  = "// This is a SPIP language file -- Ceci est un fichier langue de SPIP"
_LANGONET_TAG_DEFINITION_L  = '<LANGONET_DEFINITION_L>'
_LANGONET_TAG_DEFINITION_MANQUANTE  = '<LANGONET_DEFINITION_MANQUANTE>'
_LANGONET_TAG_DEFINITION_OBSOLETE  = '<LANGONET_DEFINITION_OBSOLETE>'
_LANGONET_TAG_MODIFIE  = '# MODIF'
_LANGONET_TAG_NOUVEAU  = '# NEW'

Functions

action_langonet_telecharger_dist()  : mixed
exec_langonet_afficher_dist()  : mixed
formulaires_langonet_editer_charger()  : mixed
formulaires_langonet_editer_verifier()  : mixed
formulaires_langonet_editer_traiter()  : mixed
formulaires_langonet_generer_charger()  : mixed
formulaires_langonet_generer_verifier()  : mixed
formulaires_langonet_generer_traiter()  : mixed
formulaires_langonet_lister_charger()  : mixed
formulaires_langonet_lister_verifier()  : mixed
formulaires_langonet_lister_traiter()  : mixed
formulaires_langonet_rechercher_charger()  : mixed
formulaires_langonet_rechercher_verifier()  : mixed
formulaires_langonet_rechercher_traiter()  : mixed
formulaires_langonet_traduire_charger()  : mixed
formulaires_langonet_traduire_verifier()  : mixed
formulaires_langonet_traduire_traiter()  : mixed
formulaires_langonet_verifier_doublon_charger()  : mixed
formulaires_langonet_verifier_doublon_verifier()  : mixed
formulaires_langonet_verifier_doublon_traiter()  : mixed
formulaires_langonet_verifier_item_charger()  : mixed
formulaires_langonet_verifier_item_verifier()  : mixed
formulaires_langonet_verifier_item_traiter()  : mixed
formulaires_langonet_verifier_l_charger()  : mixed
formulaires_langonet_verifier_l_verifier()  : mixed
formulaires_langonet_verifier_l_traiter()  : mixed
inc_generer_fichier()  : mixed
Ecriture des fichiers de langue
generer_items_cible()  : array<string|int, mixed>
ecrire_fichier_langue_php()  : bool|string
Ecriture d'un fichier de langue à partir de la liste de ces couples (item, traduction) et de son bandeau d'information Cette fonction est aussi utilisée par PlugOnet
produire_fichier_langue()  : string
Produit un fichier de langue a partir d'un tableau (index => trad) Si la traduction n'est pas une chaine mais un tableau, on inclut un commentaire
entite2utf()  : string
Conversion d'un texte en utf-8
inc_lister_items()  : array<string|int, mixed>
Creation du tableau des items de langue d'un fichier donne trie par ordre alphabetique
sauvegarder_index_langue_global()  : mixed
restaurer_index_langue_global()  : mixed
charger_module_langue()  : mixed
calculer_raccourci_brut()  : string
Calcul du représentant canonique d'une chaine de langue (_L ou <: :>).
calculer_raccourci_unique()  : string
Calcul du représentation canonique d'une chaine de langue à créer avec traitement d'homonynie.
trouver_module_langue()  : array<string|int, mixed>
verifier_reference_tradlang()  : array<string|int, mixed>
lister_modules()  : mixed
langonet_trouver_reference()  : mixed
inc_rechercher_item()  : array<string|int, mixed>
Recherche d'une chaine représentant tout ou partie d'un item de langue de SPIP et des plugins disponibles.
inc_rechercher_texte()  : array<string|int, mixed>
Recherche d'une chaine UTF-8 dans le texte francais des items de langues de SPIP et des plugins disponibles.
inc_verifier_doublon()  : array<string|int, mixed>
Vérification de l'utilisation des items de langue
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.
inc_verifier_l()  : array<string|int, mixed>
Verification de l'utilisation de la fonction _L() dans le code PHP.
langonet_autoriser()  : mixed
autoriser_langonet_onglet_dist()  : mixed
autoriser_langonet_generer_onglet_dist()  : mixed
autoriser_langonet_lister_onglet_dist()  : mixed
autoriser_langonet_rechercher_onglet_dist()  : mixed
langonet_lister_fichiers_lang()  : array<string|int, mixed>
Creation de la liste des fichiers de langue generes.
langonet_creer_bulle_fichier()  : string
Bulle d'information des liens de telechargement.
langonet_creer_select_langues()  : array<string|int, mixed>
Creation du select des fichiers de langue.
langonet_creer_select_dossiers()  : array<string|int, mixed>
Creation du select des arborescences a scanner.
langonet_cadrer_expression()  : mixed
creer_selects()  : array<string|int, mixed>
Creation d'un tableau des selects: - des fichiers de langue - des arborescences a scanner.
lister_dossiers_plugins()  : array<string|int, mixed>
Lister tous les plugins contenus dans une arborescence donnée.
langonet_lister_operations()  : mixed

Constants

_LANGONET_DOSSIERS_EXCLUS

Permet de définir les arborescences à exclure du scan des fichiers de langue.

public mixed _LANGONET_DOSSIERS_EXCLUS = ''

Les arborescences sont exprimées par une chaine simple (ecrire, plugins_dist, plugins...). Le délimiteur est le ':'. Les valeurs sont :

  • ecrire
  • prive
  • squelettes_dist
  • plugins ou auto (pour plugins/auto uniquement)
  • plugins_dist
  • plugins_suppl
  • squelettes.

_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'

_LANGONET_PATTERN_CODE_LANGUE

public mixed _LANGONET_PATTERN_CODE_LANGUE = '%_(\\w{2,3})(_\\w{2,3})?(_\\w{2,4})?$%im'

_LANGONET_PATTERN_ETAT_ITEM

public mixed _LANGONET_PATTERN_ETAT_ITEM = '%\\s[\'"]([^\'"]*)[\'"].+[\'"](?:[^\'"]*)[\'"]\\s*,?(?:\\s*#\\s*(NEW|MODIF))?$%Uims'

_LANGONET_PATTERN_FICHIERS_L

public mixed _LANGONET_PATTERN_FICHIERS_L = '(?<!/charsets|/lang|/req)(/[^/]*\\.(php))$'

_LANGONET_PATTERN_FICHIERS_LANG

public mixed _LANGONET_PATTERN_FICHIERS_LANG = '_[a-z]{2,3}\\.php$'

_LANGONET_PATTERN_FICHIERS_LANG_FR

public mixed _LANGONET_PATTERN_FICHIERS_LANG_FR = '_fr\\.php$'

_LANGONET_PATTERN_FONCTION_L

public mixed _LANGONET_PATTERN_FONCTION_L = "#\\b_L\\s*[(]\\s*([\"'])((?:\\\\\\1|[^\\1])+)\\1[^)]*\\)#Uims"

_LANGONET_PATTERN_REFERENCE

public mixed _LANGONET_PATTERN_REFERENCE = '#<traduction[^>]*reference="(.*)">#Uims'

_LANGONET_SIGNATURE_SPIP

public mixed _LANGONET_SIGNATURE_SPIP = "// This is a SPIP language file -- Ceci est un fichier langue de SPIP"

_LANGONET_TAG_DEFINITION_L

public mixed _LANGONET_TAG_DEFINITION_L = '<LANGONET_DEFINITION_L>'

_LANGONET_TAG_DEFINITION_MANQUANTE

public mixed _LANGONET_TAG_DEFINITION_MANQUANTE = '<LANGONET_DEFINITION_MANQUANTE>'

_LANGONET_TAG_DEFINITION_OBSOLETE

public mixed _LANGONET_TAG_DEFINITION_OBSOLETE = '<LANGONET_DEFINITION_OBSOLETE>'

Functions

formulaires_langonet_rechercher_charger()

formulaires_langonet_rechercher_charger(mixed $type) : mixed
Parameters
$type : mixed

formulaires_langonet_rechercher_verifier()

formulaires_langonet_rechercher_verifier(mixed $type) : mixed
Parameters
$type : mixed

formulaires_langonet_rechercher_traiter()

formulaires_langonet_rechercher_traiter(mixed $type) : mixed
Parameters
$type : mixed

inc_generer_fichier()

Ecriture des fichiers de langue

inc_generer_fichier(string $module, string $langue_source, string $ou_langue[, string $langue_cible = 'en' ][, string $mode = 'valeur' ][, string $encodage = 'utf8' ][, array<string|int, mixed> $oublis_inutiles = array() ]) : mixed
Parameters
$module : string
$langue_source : string
$ou_langue : string
$langue_cible : string = 'en'

[optional]

$mode : string = 'valeur'

[optional]

$encodage : string = 'utf8'

[optional]

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

[optional]

generer_items_cible()

generer_items_cible(mixed $items_source, mixed $items_cible[, string $mode = 'index' ][, string $encodage = 'utf8' ][, array<string|int, mixed> $oublis_inutiles = array() ]) : array<string|int, mixed>
Parameters
$items_source : mixed
$items_cible : mixed
$mode : string = 'index'
$encodage : string = 'utf8'
$oublis_inutiles : array<string|int, mixed> = array()
Return values
array<string|int, mixed>

ecrire_fichier_langue_php()

Ecriture d'un fichier de langue à partir de la liste de ces couples (item, traduction) et de son bandeau d'information Cette fonction est aussi utilisée par PlugOnet

ecrire_fichier_langue_php( $dir,  $langue,  $module,  $items, string $bandeau, mixed $langue_source) : bool|string
Parameters
$dir :
$langue :
$module :
$items :
$bandeau : string
$langue_source : mixed
Return values
bool|string

produire_fichier_langue()

Produit un fichier de langue a partir d'un tableau (index => trad) Si la traduction n'est pas une chaine mais un tableau, on inclut un commentaire

produire_fichier_langue( $langue,  $module,  $items, string $bandeau, mixed $langue_source) : string
Parameters
$langue :
$module :
$items :
$bandeau : string
$langue_source : mixed
Return values
string

entite2utf()

Conversion d'un texte en utf-8

entite2utf(string $texte) : string
Parameters
$texte : string

Texte à convertir en UTF-8

Return values
string

Texte traduit en UTF-8 ou chaine vide

inc_lister_items()

Creation du tableau des items de langue d'un fichier donne trie par ordre alphabetique

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

Nom du module de langue

$langue : string

Code SPIP de la langue

$ou_langue : string

Chemin vers le fichier de langue à vérifier

Return values
array<string|int, mixed>

sauvegarder_index_langue_global()

sauvegarder_index_langue_global() : mixed

restaurer_index_langue_global()

restaurer_index_langue_global() : mixed

charger_module_langue()

charger_module_langue(mixed $module, mixed $langue, mixed $ou_langue) : mixed
Parameters
$module : mixed
$langue : mixed
$ou_langue : mixed

calculer_raccourci_brut()

Calcul du représentant canonique d'une chaine de langue (_L ou <: :>).

calculer_raccourci_brut(string $occurrence) : string

C'est un transcodage ASCII, reduit aux 32 premiers caractères, les caractères non alphabétiques étant remplacés par un souligné. On élimine les répétitions de mots pour évacuer le cas fréquent truc: @truc@. Si le résultat a plus que 32 caractères, on élimine les mots de moins de 3 lettres. Si cela demeure toujours trop, on coupe au dernier mot complet avant 32 caractères.

Parameters
$occurrence : string
Return values
string

calculer_raccourci_unique()

Calcul du représentation canonique d'une chaine de langue à créer avec traitement d'homonynie.

calculer_raccourci_unique(string $occurrence, array<string|int, mixed> $item_md5) : string

En cas d'homonynmie, le représentant utilisé est le md5.

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

trouver_module_langue()

trouver_module_langue(string $ou_fichier) : array<string|int, mixed>
Parameters
$ou_fichier : string
Return values
array<string|int, mixed>

verifier_reference_tradlang()

verifier_reference_tradlang(string $module, string $langue, string $ou_langue) : array<string|int, mixed>
Parameters
$module : string
$langue : string
$ou_langue : string
Return values
array<string|int, mixed>

lister_modules()

lister_modules(mixed $langue[, mixed $exclure_paquet = true ]) : mixed
Parameters
$langue : mixed
$exclure_paquet : mixed = true

langonet_trouver_reference()

langonet_trouver_reference(mixed $module, mixed $ou_langue[, mixed $force = true ]) : mixed
Parameters
$module : mixed
$ou_langue : mixed
$force : mixed = true

inc_rechercher_item()

Recherche d'une chaine représentant tout ou partie d'un item de langue de SPIP et des plugins disponibles.

inc_rechercher_item(string $pattern, string $correspondance, array<string|int, mixed> $modules) : array<string|int, mixed>
Parameters
$pattern : string

le raccourci ou une partie de celui-ci à rechercher.

$correspondance : string

type de correspondance : egal, commence, ou contient

$modules : array<string|int, mixed>

tableau des modules où effectuer la recherche

Return values
array<string|int, mixed>

inc_rechercher_texte()

Recherche d'une chaine UTF-8 dans le texte francais des items de langues de SPIP et des plugins disponibles.

inc_rechercher_texte(string $pattern, string $correspondance, array<string|int, mixed> $modules) : array<string|int, mixed>
Parameters
$pattern : string

la traduction ou une partie de celle-ci à rechercher. Ce texte est en français au format UTF-8

$correspondance : string

type de correspondance : egal, commence, ou contient

$modules : array<string|int, mixed>

tableau des modules où effectuer la recherche

Return values
array<string|int, mixed>

inc_verifier_doublon()

Vérification de l'utilisation des items de langue

inc_verifier_doublon(string $verification, array<string|int, mixed> $modules) : array<string|int, mixed>
Parameters
$verification : string

Type de vérification : 'item' pour la recherche de doublons dans les raccourcis ou 'texte' pour la recherche de doublons dans les traductions

$modules : array<string|int, mixed>

Tableau des modules où effectuer la vérification

Return values
array<string|int, mixed>

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>

inc_verifier_l()

Verification de l'utilisation de la fonction _L() dans le code PHP.

inc_verifier_l(string $ou_fichier) : array<string|int, mixed>

Cette fonction construit le tableau des occurrences du premier argument de _L. Ce tableau est indexe par un representant canonique de chaque chaine trouvee. Les valeurs de ce tableau sont des sous-tableaux indexes par le nom du fichier. Chacun a pour valeur une série de sous-tableaux [n° de ligne][n° de colonne] pointant sur un tableau des résultats :

  • [0] : l'expression complète renvoyée par la regexp
  • [1] : le raccourci brut sans gestion des collisions
  • [2] : le texte du premier argument de la fonction _L
  • [3] : la ligne complète d'où est tirée l'expression reconnue
Parameters
$ou_fichier : string

Racine de l'arborescence à vérifier. On n'examine pas les ultimes sous-répertoires charsets/,lang/ , req/ et /. On n'examine que les fichiers php (voir le fichier regexp.txt).

Return values
array<string|int, mixed>

Si une erreur se produit lors du deroulement de la fonction, le tableau resultat contient le libelle de l'erreur dans l'index 'erreur'; sinon, cet index n'existe pas.

autoriser_langonet_onglet_dist()

autoriser_langonet_onglet_dist(mixed $faire, mixed $type, mixed $id, mixed $qui, mixed $opt) : mixed
Parameters
$faire : mixed
$type : mixed
$id : mixed
$qui : mixed
$opt : mixed

autoriser_langonet_generer_onglet_dist()

autoriser_langonet_generer_onglet_dist(mixed $faire, mixed $type, mixed $id, mixed $qui, mixed $opt) : mixed
Parameters
$faire : mixed
$type : mixed
$id : mixed
$qui : mixed
$opt : mixed

autoriser_langonet_lister_onglet_dist()

autoriser_langonet_lister_onglet_dist(mixed $faire, mixed $type, mixed $id, mixed $qui, mixed $opt) : mixed
Parameters
$faire : mixed
$type : mixed
$id : mixed
$qui : mixed
$opt : mixed

autoriser_langonet_rechercher_onglet_dist()

autoriser_langonet_rechercher_onglet_dist(mixed $faire, mixed $type, mixed $id, mixed $qui, mixed $opt) : mixed
Parameters
$faire : mixed
$type : mixed
$id : mixed
$qui : mixed
$opt : mixed

langonet_lister_fichiers_lang()

Creation de la liste des fichiers de langue generes.

langonet_lister_fichiers_lang([mixed $operation = 'generation' ]) : array<string|int, mixed>
Parameters
$operation : mixed = 'generation'
Return values
array<string|int, mixed>

langonet_creer_bulle_fichier()

Bulle d'information des liens de telechargement.

langonet_creer_bulle_fichier(string $fichier[, string $type = 'lang' ][, string $action = 'telecharger' ]) : string
Parameters
$fichier : string
$type : string = 'lang'
$action : string = 'telecharger'
Return values
string

langonet_creer_select_langues()

Creation du select des fichiers de langue.

langonet_creer_select_langues([string $sel_l = '0' ][, mixed $exclure_paquet = true ]) : array<string|int, mixed>
Parameters
$sel_l : string = '0'
$exclure_paquet : mixed = true
Return values
array<string|int, mixed>

langonet_creer_select_dossiers()

Creation du select des arborescences a scanner.

langonet_creer_select_dossiers([string $sel_d = array() ][, mixed $multiple = true ]) : array<string|int, mixed>
Parameters
$sel_d : string = array()
$multiple : mixed = true
Return values
array<string|int, mixed>

langonet_cadrer_expression()

langonet_cadrer_expression(mixed $expression, mixed $colonne, mixed $ligne, mixed $fichier[, mixed $cadre = 4 ]) : mixed
Parameters
$expression : mixed
$colonne : mixed
$ligne : mixed
$fichier : mixed
$cadre : mixed = 4

creer_selects()

Creation d'un tableau des selects: - des fichiers de langue - des arborescences a scanner.

creer_selects([string $sel_l = '0' ][, array<string|int, mixed> $sel_d = array() ][, mixed $exclure_paquet = true ][, mixed $multiple = true ]) : array<string|int, mixed>
Parameters
$sel_l : string = '0'

option du select des langues

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

option(s) du select des repertoires

$exclure_paquet : mixed = true
$multiple : mixed = true
Return values
array<string|int, mixed>

lister_dossiers_plugins()

Lister tous les plugins contenus dans une arborescence donnée.

lister_dossiers_plugins([string $racine_arborescence = null ]) : array<string|int, mixed>
Parameters
$racine_arborescence : string = null
Return values
array<string|int, mixed>

Search results