Saisies

Application

Functions

champs_extras_calculer_balise_LISTER_VALEURS_choix_grille() : array<string|int, mixed>|string: Déclaration de la balise LISTER_VALEURS pour la saisie `choix_grille`
champs_extras_serialiser_choix_grille() : string: Sérialise les réponses à un champ extra de type `choix_grille` pour encodage en base.
formulaires_configurer_saisies_saisies_dist() : array<string|int, mixed>: Saisies du formulaire de configuration de saisies
formulaires_construire_formulaire_charger() : array<string|int, mixed>: Formulaire permettant de construire un formulaire ! En agençant des champs Chargement.
formulaires_construire_formulaire_verifier() : mixed
formulaires_construire_formulaire_traiter() : mixed
construire_formulaire_generer_saisie_configurable() : string: Préparer une saisie pour la transformer en truc configurable
saisies_groupe_inserer() : mixed
construire_formulaire_config_inserer_option_depublie() : array<string|int, mixed>: Insérer dans le formulaire de config l'option pour dépublier une saisie
formulaires_saisies_cvt_saisies_dist() : mixed
formulaires_saisies_cvt_charger() : mixed
saisie_editable() : bool: Indique si une saisie peut être affichée.
saisies_generer_html() : string: Génère une saisie à partir d'un tableau la décrivant et de l'environnement.
saisies_generer_vue() : string: Génère une vue d'une saisie à partir d'un tableau la décrivant.
saisies_trouver_erreur() : string: Récupère l'erreur d'une saisie particulière au sein d'un tableau d'erreur
saisies_afficher_normaliser_options_attributs() : array<string|int, mixed>: Normaliser l'option `attributs` d'une saisie individuelle En mergeant les attributs_data
saisies_saisie_est_tabulaire() : return: La saisie renvoie t-elle un tableau? note: on teste saisie par saisie, et non pas type de saisie par type de saisie, car certains types (`selection` par ex.) peuvent, en fonction des options, être tabulaire ou pas.
saisies_saisie_est_fichier() : bool: La saisie remplie-t-elle `$_FILES` ? note: on teste saisie par saisie, et non pas type de saisie par type de saisie, car certains types (`input` par ex.) peuvent, en fonction des options, être fichier ou pas.
saisies_saisie_est_gelee() : bool: Indique si une saisie à sa valeur gelée - soit par option disabled avec envoi cachée - soit par option readonly
saisies_verifier_gel_saisie() : bool
saisies_saisie_est_avec_sous_saisies() : bool: Renvoie true si la saisie est un conteneur de sous saisies, qu'elle contienne effectivement des sous saisies ou pas
saisies_saisie_est_labelisable() : bool: Renvoie true si la saisie peut recevoir un label, qu'elle contienne effectivement un label ou pas
saisies_saisie_est_champ() : bool: Renvoie true si la saisie correspond à un champ au sens HTML
saisies_saisie_get_label() : string: Renvoi le label de la saisie la plupart du temps c'est juste le champ label mais pour certaines saisies c'est autre chose
saisies_lister_par_identifiant() : array<string|int, mixed>: Prend la description complète du contenu d'un formulaire et retourne les saisies "à plat" classées par identifiant unique.
saisies_lister_par_nom() : array<string|int, mixed>: Prend la description complète du contenu d'un formulaire et retourne les saisies "à plat" classées par nom.
saisies_lister_finales() : liste: Liste les saisies en parcourant tous les niveau de la hiérarchie, et en excluant les saisies ayant des sous-saisies
saisies_lister_avec_option() : liste: Liste les saisies ayant une option X # saisies_lister_avec_option('sql', $saisies);.
saisies_lister_avec_sql() : liste: Liste les saisies ayant une definition SQL.
saisies_lister_avec_type() : liste: Liste les saisies d'un certain type.
saisies_lister_par_type() : array<string|int, mixed>: Prend la description complète du contenu d'un formulaire et retourne les saisies "à plat" classées par type de saisie.
saisies_lister_par_etapes() : array<string|int, mixed>|bool: Liste les saisies par étapes s'il y en a
saisies_lister_champs() : array<string|int, mixed>: Prend la description complète du contenu d'un formulaire et retourne une liste des noms des champs du formulaire.
saisies_lister_labels() : array<string|int, mixed>: Prend la description complète du contenu d'un formulaire et retourne une liste des labels humains des vrais champs du formulaire (par nom)
saisies_charger_champs() : array<string|int, mixed>: A utiliser dans une fonction charger d'un formulaire CVT, cette fonction renvoie le tableau de contexte correspondant de la forme $contexte['nom_champ'] = ''.
saisies_lister_valeurs_defaut() : array<string|int, mixed>: Prend la description complète du contenu d'un formulaire et retourne une liste des valeurs par défaut des champs du formulaire.
saisies_comparer() : array<string|int, mixed>: Compare deux tableaux de saisies pour connaitre les différences.
saisies_comparer_rappel() : int: Compare deux saisies et indique si elles sont égales ou pas.
saisies_comparer_par_identifiant() : array<string|int, mixed>: Compare deux tableaux de saisies pour connaitre les différences en s'appuyant sur les identifiants de saisies.
saisies_autonomes() : array<string|int, mixed>: Quelles sont les saisies qui se débrouillent toutes seules, sans le _base commun.
saisies_chercher() : array<string|int, mixed>: Cherche une saisie par son id, son nom ou son chemin et renvoie soit la saisie, soit son chemin
saisies_lister_champs_par_section() : array<string|int, mixed>: Prend un tableau de saisie retourne un tableau contenant uniquement les champs de saisie organisé par section (fieldset), avec pour chaque saisie le nom de la saisie en clé
saisies_dont_avec_option() : bool: Indique si dans une liste de saisies, au moins l'une d'entre elle possède l'option `$option` Optimisée par rapport à `saisies_lister_avec_option()` car s'arrête de parcourir dès la première saisies trouvée
saisies_lister_disponibles() : array<string|int, mixed>: Liste toutes les saisies configurables (ayant une description).
saisies_groupes_lister_disponibles() : array<string|int, mixed>: Liste tous les groupes de saisies configurables (ayant une description).
saisies_lister_disponibles_sql() : array<string|int, mixed>: Lister les saisies existantes ayant une définition SQL.
saisies_charger_infos() : array<string|int, mixed>: Charger les informations contenues dans le YAML d'une saisie.
saisies_recuperer_heritage() : array<string|int, mixed>: Permet à une saisie d'hériter des options et valeur par défaut d'une autre saisies
saisies_lister_categories() : array<string|int, mixed>: Lister les catégories par défaut, puis les envoyer au pipeline
saisies_lister_disponibles_par_categories() : array<string|int, mixed>: Lister les saisies disponibles en les regroupant en catégories
saisies_lister_disponibles_sql_par_categories() : mixed: Liste par catégorie les saisies disponibles ayant une définition SQL
saisies_regrouper_disponibles_par_categories() : array<string|int, mixed>: Regroupe par categories les saisies
saisies_lister_disponibles_par_categories_usort() : int: Function de comparaison pour trier les saisies disponibles par rang Si pas de rang défini, on met après ceux avec rang Si deux saisies avec le même rang, on se rabat sur l'ordre alpha
saisies_supprimer() : array<string|int, mixed>: Supprimer une saisie dont on donne l'identifiant, le nom ou le chemin.
saisies_inserer() : array<string|int, mixed>: Insère une saisie à une position donnée dans un tableau de donnée - soit en lui passant un chemin - soit en lui passant une saisie devant laquelle se placer
saisies_inserer_avant() : array<string|int, mixed>: Insère une saisie avant une autre saisie.
saisies_inserer_apres() : array<string|int, mixed>: Insère une saisie après une autre saisie.
saisies_inserer_selon_chemin() : array<string|int, mixed>: Insère une saisie à une position donnée, en lui passant un chemin.
saisies_dupliquer() : array<string|int, mixed>: Duplique une saisie (ou groupe de saisies) en placant la copie à la suite de la saisie d'origine.
saisies_deplacer() : array<string|int, mixed>: Déplace une saisie existante autre part.
saisies_deplacer_avant() : array<string|int, mixed>: Déplacer une saisie existante avant une autre
saisies_deplacer_apres() : array<string|int, mixed>: Déplacer une saisie existante après une autre
saisies_modifier() : array<string|int, mixed>: Modifie une saisie.
saisies_transformer_noms() : array<string|int, mixed>: Transforme tous les noms du formulaire avec un preg_replace.
saisies_encapsuler_noms() : array<string|int, mixed>: Transforme tous les noms en les encapsulant avec un préfixe.
saisies_transformer_option() : array<string|int, mixed>: Transforme toutes les options textuelles d'un certain nom, avec un preg_replace.
saisies_mapper_option() : array<string|int, mixed>: Modifie toutes les options d'un certain nom, avec une fonction de rappel.
saisies_supprimer_option() : array<string|int, mixed>: Supprime toutes les options d'un certain nom.
saisies_mapper_verifier() : array<string|int, mixed>: Modifie les vérifications des saisies avec une fonction de rappel
saisies_transformer_noms_auto() : array<string|int, mixed>: Transforme les noms d'une liste de saisies pour qu'ils soient uniques dans le formulaire donné.
saisies_inserer_html() : array<string|int, mixed>: Insère du HTML au début ou à la fin d'une saisie.
saisies_fieldsets_en_onglets() : array<string|int, mixed>: Ajoute l'option onglet aux fieldset de premier niveau dans un tableau de $saisie Ajoute également un identifiant unique, éventuellement préfixé
saisies_supprimer_sans_reponse() : array<string|int, mixed>: Prend un tableau de saisies Enlève les saisies qui n'ont rien dans _request Ou dont l'ensemble des sous-saisies sont vides
saisies_saisie_possede_reponse() : bool: Indique si une saisie possède une réponse
saisies_supprimer_depublie() : array<string|int, mixed>: Prend un tableau de saisies Enlève les saisies dépubliées Ou dont l'ensemble des sous-saisies sont dépubliés
saisies_supprimer_depublie_sans_reponse() : array<string|int, mixed>: Prend un tableau de saisies Enlève les saisies dépubliées Et qui n'ont pas de réponse Ou dont l'ensemble des saisies répondent au critère ci-dessus
saisies_supprimer_callback() : array<string|int, mixed>: Prend un tableau de saisies supprime les saisies selon une fonction de rappel
saisies_wrapper_fieldset() : array<string|int, mixed>: Transforme un tableau de saisies en englobant le tout dans un fieldset utilisé pour la prévisualisation
saisies_migrer_afficher_si_remplissage() : array<string|int, mixed>: Parcours un tableau de saisies, regarde si on a un champ afficher_si_remplissage et le transforme en champs afficher_si + afficher_si_remplissage_uniquement
construire_configuration_saisie() : mixed
conteneur_inline_est_avec_sous_saisies() : bool: Un conteneur_inline, c'est une saisie contenante
conteneur_inline_est_labelisable() : bool: Un conteneur_inline, ca n'a pas de label
conteneur_inline_est_champ() : bool: Un conteneur_inline, ca n'est pas un champ
explication_est_champ() : bool: Une explication, ca n'est pas un champ
explication_get_label() : string: Retourne le label de la saisie `explication` Par ordre de priorité le `titre` sinon le `texte`
fieldset_est_avec_sous_saisies() : bool: Un fieldset, c'est une saisie contenante
fieldset_est_champ() : bool: Un fieldset, ca n'est pas un champ
remplir_tableau_mime() : array<string|int, mixed>: Remplit un tableau de description de types mime Sous la forme type_mime => 'Nom du type (extensions)'
verifier_afficher_si_dist() : string
verifier_saisies_option_data_dist() : string: Vérifier qu'une saisie est sous forme d'une chaine transformable en tableau de data C'est-à-dire de la forme cle|valeur Et ce en autorisant les sous-groupes (sauf si demande contraire) Mais en refusant les clés construite automatiquement pour des lignes sans pipe.
verifier_valeurs_acceptables_dist() : string

champs_extras_calculer_balise_LISTER_VALEURS_choix_grille()

Déclaration de la balise LISTER_VALEURS pour la saisie `choix_grille`


    
                    champs_extras_calculer_balise_LISTER_VALEURS_choix_grille(string $objet, string $colonne, string $cles) : array<string|int, mixed>|string

Parameters

$objet : string: Type d'objet
$colonne : string: Nom de la colonne SQL
$cles : string: Valeurs enregistrées pour ce champ dans la bdd pour l'objet en cours

Return values

array<string|int, mixed>|string —

vide Tableau de type 'Clé de ligne|Valeur de ligne' => 'Ligne en valeur humaine|Valeur de ligne en humain'. Par ex 'Ligne1|Colonne1' => 'Ma première ligne|Ma première colonne'

champs_extras_serialiser_choix_grille()

Sérialise les réponses à un champ extra de type `choix_grille` pour encodage en base.


    
                    champs_extras_serialiser_choix_grille(array<string|int, mixed> $extra, array<string|int, mixed> $saisie) : string

Parameters

$extra : array<string|int, mixed>: La valeur reçue en POST
$saisie : array<string|int, mixed>: La description de la saisie

Return values

string —

Forme serialisé, en l'occurence avec saisies_tableau2chaine

formulaires_configurer_saisies_saisies_dist()

Saisies du formulaire de configuration de saisies


    
                    formulaires_configurer_saisies_saisies_dist() : array<string|int, mixed>

Return values

array<string|int, mixed>

formulaires_construire_formulaire_charger()

Formulaire permettant de construire un formulaire ! En agençant des champs Chargement.


    
                    formulaires_construire_formulaire_charger(string $identifiant[, mixed $formulaire_initial = [] ][, array<string|int, mixed> $options = [] ]) : array<string|int, mixed>

Parameters

$identifiant : string

identifiant unique du formulaire

$formulaire_initial : mixed = []

$options : array<string|int, mixed> = []

tableau d'options

array options_globales : proposer des options globales pour le formulaire, liste de ces options
array saisies_exclues : liste des saisies à ne pas proposer (= à exclure du choix)
bool uniquement_sql : ne proposer que les saisies qui permettent de remplir un champ sql

Return values

array<string|int, mixed> —

$contexte

formulaires_construire_formulaire_verifier()


    
                    formulaires_construire_formulaire_verifier(mixed $identifiant[, mixed $formulaire_initial = [] ][, mixed $options = [] ]) : mixed

Parameters

$identifiant : mixed
$formulaire_initial : mixed = []
$options : mixed = []

formulaires_construire_formulaire_traiter()


    
                    formulaires_construire_formulaire_traiter(mixed $identifiant[, mixed $formulaire_initial = [] ][, mixed $options = [] ]) : mixed

Parameters

$identifiant : mixed
$formulaire_initial : mixed = []
$options : mixed = []

construire_formulaire_generer_saisie_configurable()

Préparer une saisie pour la transformer en truc configurable


    
                    construire_formulaire_generer_saisie_configurable(array<string|int, mixed> $saisie, array<string|int, mixed> $env) : string

Parameters

$saisie : array<string|int, mixed>: description de la saisie
$env : array<string|int, mixed>: environnement d'appel

Return values

string —

fond du formulaire

saisies_groupe_inserer()


    
                    saisies_groupe_inserer(mixed $formulaire_actuel, mixed $saisie) : mixed

Parameters

$formulaire_actuel : mixed
$saisie : mixed

construire_formulaire_config_inserer_option_depublie()

Insérer dans le formulaire de config l'option pour dépublier une saisie


    
                    construire_formulaire_config_inserer_option_depublie(array<string|int, mixed> $saisies) : array<string|int, mixed>

Parameters

$saisies : array<string|int, mixed>

Return values

array<string|int, mixed>

formulaires_saisies_cvt_saisies_dist()


    
                    formulaires_saisies_cvt_saisies_dist() : mixed

formulaires_saisies_cvt_charger()


    
                    formulaires_saisies_cvt_charger() : mixed

saisie_editable()

Indique si une saisie peut être affichée.


    
                    saisie_editable(array<string|int, mixed> $champ, array<string|int, mixed> $env[, bool $utiliser_editable = true ]) : bool

On utilise en priorité l'option depublie. Si activée, la saisie n'est pas affichée sauf si valeur déjà présente.

Mais par compatibilité historique, on peut s'appuyer sur l'éventuelle clé "editable" du $champ. Si editable vaut :

absent : le champ est éditable
1, le champ est éditable
0, le champ n'est pas éditable
-1, le champ est éditable s'il y a du contenu dans le champ (l'environnement) ou dans un de ses enfants (fieldsets)

Parameters

$champ : array<string|int, mixed>

Tableau de description de la saisie

$env : array<string|int, mixed>

Environnement transmis à la saisie, certainement l'environnement du formulaire

$utiliser_editable : bool = true

false pour juste tester le cas -1

Return values

bool —

Retourne un booléen indiquant l'état éditable ou pas :

true si la saisie est éditable (peut être affichée)
false sinon

saisies_generer_html()

Génère une saisie à partir d'un tableau la décrivant et de l'environnement.


    
                    saisies_generer_html(array<string|int, mixed> $champ[, array<string|int, mixed> $env = [] ]) : string

Parameters

$champ : array<string|int, mixed>: Description de la saisie. Le tableau doit être de la forme suivante : array( 'saisie' => 'input', 'options' => array( 'nom' => 'le_name', 'label' => 'Un titre plus joli', 'obligatoire' => 'oui', 'explication' => 'Remplissez ce champ en utilisant votre clavier.' ) )
$env : array<string|int, mixed> = []: Environnement du formulaire Permet de savoir les valeurs actuelles des contenus des saisies, les erreurs eventuelles présentes...

Return values

string —

Code HTML des saisies de formulaire

saisies_generer_vue()

Génère une vue d'une saisie à partir d'un tableau la décrivant.


    
                    saisies_generer_vue(array<string|int, mixed> $saisie[, array<string|int, mixed> $env = [] ][, array<string|int, mixed> $env_obligatoire = [] ]) : string

Parameters

$saisie : array<string|int, mixed>: Tableau de description d'une saisie
$env : array<string|int, mixed> = []: L'environnement, contenant normalement la réponse à la saisie
$env_obligatoire : array<string|int, mixed> = []: Ce qui doit toujours être passé à l'environnement

Return values

string —

Code HTML de la vue de la saisie

saisies_trouver_erreur()

Récupère l'erreur d'une saisie particulière au sein d'un tableau d'erreur


    
                    saisies_trouver_erreur(array<string|int, mixed>|null $erreurs, string $nom_ou_name) : string

Parameters

$erreurs : array<string|int, mixed>|null

Tableau d'erreurs, 3 formats possibles

- Arborescents SPIP 'niveau1/niveau2/niveau3' => 'erreur'
- Arborescents HTML 'niveau1[niveau2][niveau3]' => 'erreur'
- Arborescents PHP ['niveau1' => ['niveau2' => 'niveau3' => 'erreur']]]

$nom_ou_name : string

Return values

string

saisies_afficher_normaliser_options_attributs()

Normaliser l'option `attributs` d'une saisie individuelle En mergeant les attributs_data


    
                    saisies_afficher_normaliser_options_attributs(array<string|int, mixed> $options) : array<string|int, mixed>

Parameters

$options : array<string|int, mixed>: liste des options de la saisie

Return values

array<string|int, mixed> —

$options liste des options, normalisée

saisies_saisie_est_tabulaire()

La saisie renvoie t-elle un tableau? note: on teste saisie par saisie, et non pas type de saisie par type de saisie, car certains types (`selection` par ex.) peuvent, en fonction des options, être tabulaire ou pas.


    
                    saisies_saisie_est_tabulaire(mixed $saisie) : return

Parameters

$saisie : mixed

Return values

return —

bool true si la saisie est tabulaire, false sinon

saisies_saisie_est_fichier()

La saisie remplie-t-elle `$_FILES` ? note: on teste saisie par saisie, et non pas type de saisie par type de saisie, car certains types (`input` par ex.) peuvent, en fonction des options, être fichier ou pas.


    
                    saisies_saisie_est_fichier(array<string|int, mixed> $saisie) : bool

Parameters

$saisie : array<string|int, mixed>

Return values

bool

saisies_saisie_est_gelee()

Indique si une saisie à sa valeur gelée - soit par option disabled avec envoi cachée - soit par option readonly


    
                    saisies_saisie_est_gelee(array<string|int, mixed> $description) : bool

Parameters

$description : array<string|int, mixed>: description de la saisie

Return values

bool —

true si gélée, false sinon)

saisies_verifier_gel_saisie()

saisies_verifier_gel_saisie Renommée en saisies_saisie_est_gelee


    
                    saisies_verifier_gel_saisie(array<string|int, mixed> $description) : bool

Parameters

$description : array<string|int, mixed>

Return values

bool

saisies_saisie_est_avec_sous_saisies()

Renvoie true si la saisie est un conteneur de sous saisies, qu'elle contienne effectivement des sous saisies ou pas


    
                    saisies_saisie_est_avec_sous_saisies(array<string|int, mixed> $saisie) : bool

Parameters

$saisie : array<string|int, mixed>

Return values

bool

saisies_saisie_est_labelisable()

Renvoie true si la saisie peut recevoir un label, qu'elle contienne effectivement un label ou pas


    
                    saisies_saisie_est_labelisable(array<string|int, mixed> $saisie) : bool

Parameters

$saisie : array<string|int, mixed>

Return values

bool

saisies_saisie_est_champ()

Renvoie true si la saisie correspond à un champ au sens HTML


    
                    saisies_saisie_est_champ(array<string|int, mixed> $saisie) : bool

Parameters

$saisie : array<string|int, mixed>

Return values

bool

saisies_saisie_get_label()

Renvoi le label de la saisie la plupart du temps c'est juste le champ label mais pour certaines saisies c'est autre chose


    
                    saisies_saisie_get_label(array<string|int, mixed> $saisie) : string

Parameters

$saisie : array<string|int, mixed>

Return values

string

saisies_lister_par_identifiant()

Prend la description complète du contenu d'un formulaire et retourne les saisies "à plat" classées par identifiant unique.


    
                    saisies_lister_par_identifiant(array<string|int, mixed> $contenu[, bool $avec_conteneur = true ]) : array<string|int, mixed>

Parameters

$contenu : array<string|int, mixed>: Le contenu d'un formulaire
$avec_conteneur : bool = true: Indique si on renvoie aussi les saisies ayant des enfants, comme les fieldsets

Return values

array<string|int, mixed> —

Un tableau avec uniquement les saisies

saisies_lister_par_nom()

Prend la description complète du contenu d'un formulaire et retourne les saisies "à plat" classées par nom.


    
                    saisies_lister_par_nom(array<string|int, mixed> $contenu[, bool $avec_conteneur = true ]) : array<string|int, mixed>

Parameters

$contenu : array<string|int, mixed>: Le contenu d'un formulaire
$avec_conteneur : bool = true: Indique si on renvoie aussi les saisies ayant des enfants, comme les fieldset

Return values

array<string|int, mixed> —

Un tableau avec uniquement les saisies

saisies_lister_finales()

Liste les saisies en parcourant tous les niveau de la hiérarchie, et en excluant les saisies ayant des sous-saisies


    
                    saisies_lister_finales(array<string|int, mixed> $saisies) : liste

Parameters

$saisies : array<string|int, mixed>: Liste de saisies

Return values

liste —

de ces saisies triées selon l'ordre de déclaration initiale

saisies_lister_avec_option()

Liste les saisies ayant une option X # saisies_lister_avec_option('sql', $saisies);.


    
                    saisies_lister_avec_option(string $option, array<string|int, mixed> $saisies[, string $tri = 'nom' ]) : liste

Parameters

$option : string: Nom de l'option cherchée
$saisies : array<string|int, mixed>: Liste de saisies
$tri : string = 'nom': tri par défaut des résultats (s'ils ne sont pas deja triés) ('nom', 'identifiant')

Return values

liste —

de ces saisies triees par nom ayant une option X définie

saisies_lister_avec_sql()

Liste les saisies ayant une definition SQL.


    
                    saisies_lister_avec_sql(array<string|int, mixed> $saisies[, string $tri = 'nom' ]) : liste

Parameters

$saisies : array<string|int, mixed>: liste de saisies
$tri : string = 'nom': tri par défaut des résultats (s'ils ne sont pas deja triés) ('nom', 'identifiant')

Return values

liste —

de ces saisies triees par nom ayant une option sql définie

saisies_lister_avec_type()

Liste les saisies d'un certain type.


    
                    saisies_lister_avec_type(array<string|int, mixed> $saisies, string|array<string|int, mixed> $type[, string $tri = 'nom' ][, mixed $avec_conteneur = false ]) : liste

Parameters

$saisies : array<string|int, mixed>: liste de saisies
$type : string|array<string|int, mixed>: Type de la saisie, ou tableau de types
$tri : string = 'nom': tri par défaut des résultats (s'ils ne sont pas deja triés) ('nom')
$avec_conteneur : mixed = false

Return values

liste —

de ces saisies triees par nom

saisies_lister_par_type()

Prend la description complète du contenu d'un formulaire et retourne les saisies "à plat" classées par type de saisie.


    
                    saisies_lister_par_type(array<string|int, mixed> $contenu) : array<string|int, mixed>

$saisie['input']['input_1'] = $saisie.

Attention : ne sont retournées que les saisies finales (qui ne contiennent pas de sous-saisies).

Parameters

$contenu : array<string|int, mixed>: Le contenu d'un formulaire

Return values

array<string|int, mixed> —

Un tableau avec uniquement les saisies

saisies_lister_par_etapes()

Liste les saisies par étapes s'il y en a


    
                    saisies_lister_par_etapes(array<string|int, mixed> $saisies[, bool $check_only = false ][, array<string|int, mixed>|null $env = [] ]) : array<string|int, mixed>|bool

Parameters

$saisies : array<string|int, mixed>: Liste des saisies
$check_only : bool = false: = false, si true, se contente de vérifier si on gère les étapes, mais ne construit pas le tableau d'étape
$env : array<string|int, mixed>|null = []

Return values

array<string|int, mixed>|bool —

Retourne un tableau associatif par numéro d'étape avec pour chacune leurs saisies (ou bien true si check_only est à true), false si pas d'étapes Retourne un tableau associatif "etape_xxx" => "contenu de l'étape" avec pour chacune leurs saisies, false si pas d'étapes Ajoute si besoin une étape N+1 "Récapitulatif" Les noms des étapes sont automatiquement passés dans _T_ou_typo

saisies_lister_champs()

Prend la description complète du contenu d'un formulaire et retourne une liste des noms des champs du formulaire.


    
                    saisies_lister_champs(array<string|int, mixed> $contenu[, bool $avec_conteneur = true ]) : array<string|int, mixed>

Parameters

$contenu : array<string|int, mixed>: Le contenu d'un formulaire
$avec_conteneur : bool = true: Indique si on renvoie aussi les saisies ayant des enfants, comme les fieldset

Return values

array<string|int, mixed> —

Un tableau listant les noms des champs

saisies_lister_labels()

Prend la description complète du contenu d'un formulaire et retourne une liste des labels humains des vrais champs du formulaire (par nom)


    
                    saisies_lister_labels(array<string|int, mixed> $contenu[, bool $avec_conteneur = false ]) : array<string|int, mixed>

Parameters

$contenu : array<string|int, mixed>: Le contenu d'un formulaire
$avec_conteneur : bool = false: Indique si on renvoie aussi les saisies ayant des enfants, comme les fieldset

Return values

array<string|int, mixed> —

Un tableau listant les labels humains des champs

saisies_charger_champs()

A utiliser dans une fonction charger d'un formulaire CVT, cette fonction renvoie le tableau de contexte correspondant de la forme $contexte['nom_champ'] = ''.


    
                    saisies_charger_champs(array<string|int, mixed> $contenu) : array<string|int, mixed>

Parameters

$contenu : array<string|int, mixed>: Le contenu d'un formulaire (un tableau de saisies)

Return values

array<string|int, mixed> —

Un tableau de contexte

saisies_lister_valeurs_defaut()

Prend la description complète du contenu d'un formulaire et retourne une liste des valeurs par défaut des champs du formulaire.


    
                    saisies_lister_valeurs_defaut(array<string|int, mixed> $contenu) : array<string|int, mixed>

Parameters

$contenu : array<string|int, mixed>: Le contenu d'un formulaire

Return values

array<string|int, mixed> —

Un tableau renvoyant la valeur par défaut de chaque champs

saisies_comparer()

Compare deux tableaux de saisies pour connaitre les différences.


    
                    saisies_comparer(array<string|int, mixed> $saisies_anciennes, array<string|int, mixed> $saisies_nouvelles[, bool $avec_conteneur = true ][, string $tri = 'nom' ]) : array<string|int, mixed>

Parameters

$saisies_anciennes : array<string|int, mixed>: Un tableau décrivant des saisies
$saisies_nouvelles : array<string|int, mixed>: Un autre tableau décrivant des saisies
$avec_conteneur : bool = true: Indique si on veut prendre en compte dans la comparaison les conteneurs comme les fieldsets
$tri : string = 'nom': Comparer selon quel tri ? 'nom' / 'identifiant'

Return values

array<string|int, mixed> —

Retourne le tableau des saisies supprimées, ajoutées et modifiées

saisies_comparer_rappel()

Compare deux saisies et indique si elles sont égales ou pas.


    
                    saisies_comparer_rappel(array<string|int, mixed> $a, array<string|int, mixed> $b) : int

Parameters

$a : array<string|int, mixed>: Une description de saisie
$b : array<string|int, mixed>: Une autre description de saisie

Return values

int —

Retourne 0 si les saisies sont identiques, 1 sinon.

saisies_comparer_par_identifiant()

Compare deux tableaux de saisies pour connaitre les différences en s'appuyant sur les identifiants de saisies.


    
                    saisies_comparer_par_identifiant(array<string|int, mixed> $saisies_anciennes, array<string|int, mixed> $saisies_nouvelles[, bool $avec_conteneur = true ]) : array<string|int, mixed>

Parameters

$saisies_anciennes : array<string|int, mixed>: Un tableau décrivant des saisies
$saisies_nouvelles : array<string|int, mixed>: Un autre tableau décrivant des saisies
$avec_conteneur : bool = true: Indique si on veut prendre en compte dans la comparaison les conteneurs comme les fieldsets

Return values

array<string|int, mixed> —

Retourne le tableau des saisies supprimées, ajoutées et modifiées

saisies_autonomes()

Quelles sont les saisies qui se débrouillent toutes seules, sans le _base commun.


    
                    saisies_autonomes() : array<string|int, mixed>

Return values

array<string|int, mixed> —

Retourne un tableau contenant les types de saisies qui ne doivent pas utiliser le _base.html commun

saisies_chercher()

Cherche une saisie par son id, son nom ou son chemin et renvoie soit la saisie, soit son chemin


    
                    saisies_chercher(array<string|int, mixed> $saisies, array<string|int, mixed>|string $id_ou_nom_ou_chemin[, bool $retourner_chemin = false ]) : array<string|int, mixed>

Parameters

$saisies : array<string|int, mixed>: Un tableau décrivant les saisies
$id_ou_nom_ou_chemin : array<string|int, mixed>|string: L'identifiant ou le nom de la saisie à chercher ou le chemin sous forme d'une liste de clés
$retourner_chemin : bool = false: Indique si on retourne non pas la saisie mais son chemin

Return values

array<string|int, mixed> —

Retourne soit la saisie, soit son chemin, soit null

saisies_lister_champs_par_section()

Prend un tableau de saisie retourne un tableau contenant uniquement les champs de saisie organisé par section (fieldset), avec pour chaque saisie le nom de la saisie en clé


    
                    saisies_lister_champs_par_section(array<string|int, mixed> $saisies[, array<string|int, mixed> $options = [] ]) : array<string|int, mixed>

Parameters

$saisies : array<string|int, mixed>

le tableau de saisie

$options : array<string|int, mixed> = []

tableau d'options

string callback_section nom de la fonction de rappel sur les section, à défaut prend le nom ; exemple : 'saisies_saisie_get_label'
string callback_champ nom de la fonction de rappel sur les champ, à défaut renvoie la saisie complète ; exemple : 'saisies_saisie_get_label'
int profondeur_max_output indique sur combien de niveau doit être le tableau d'output, si pas défini / <= 0 , va jusqu'au bout de la hiérarchie, sinon ca aplatit les niveaux les plus profonds
bool sans_vide: si True, ne pas renvoyer les section vide
array|string forcer_type: liste de type à prendre, en excluant les autres

Return values

array<string|int, mixed>

saisies_dont_avec_option()

Indique si dans une liste de saisies, au moins l'une d'entre elle possède l'option `$option` Optimisée par rapport à `saisies_lister_avec_option()` car s'arrête de parcourir dès la première saisies trouvée


    
                    saisies_dont_avec_option([array<string|int, mixed> $saisies = [] ][, string $option = '' ]) : bool

Parameters

$saisies : array<string|int, mixed> = []
$option : string = ''

Return values

bool

saisies_lister_disponibles()

Liste toutes les saisies configurables (ayant une description).


    
                    saisies_lister_disponibles([string $saisies_repertoire = 'saisies' ][, bool $inclure_obsoletes = true ]) : array<string|int, mixed>

Parameters

$saisies_repertoire : string = 'saisies': le répertoire où trouver les saisies
$inclure_obsoletes : bool = true: : faut-il inclure les saisies obsolètes ?

Return values

array<string|int, mixed> —

Un tableau listant des saisies et leurs options

saisies_groupes_lister_disponibles()

Liste tous les groupes de saisies configurables (ayant une description).


    
                    saisies_groupes_lister_disponibles([mixed $saisies_repertoire = 'saisies' ]) : array<string|int, mixed>

Parameters

$saisies_repertoire : mixed = 'saisies'

Return values

array<string|int, mixed> —

Un tableau listant des saisies et leurs options

saisies_lister_disponibles_sql()

Lister les saisies existantes ayant une définition SQL.


    
                    saisies_lister_disponibles_sql([string $saisies_repertoire = 'saisies' ][, bool $inclure_obsoletes = true ]) : array<string|int, mixed>

Parameters

$saisies_repertoire : string = 'saisies': le répertoire où trouver les saisies
$inclure_obsoletes : bool = true: : faut-il inclure les saisies obsolètes ?

Return values

array<string|int, mixed> —

Un tableau listant des saisies et leurs options

saisies_charger_infos()

Charger les informations contenues dans le YAML d'une saisie.


    
                    saisies_charger_infos(string $type_saisie[, mixed $saisies_repertoire = 'saisies' ]) : array<string|int, mixed>

Parameters

$type_saisie : string: Le type de la saisie
$saisies_repertoire : mixed = 'saisies'

Return values

array<string|int, mixed> —

Un tableau contenant le YAML décodé

saisies_recuperer_heritage()

Permet à une saisie d'hériter des options et valeur par défaut d'une autre saisies


    
                    saisies_recuperer_heritage(string $saisie[, string $saisies_repertoire = 'saisies' ]) : array<string|int, mixed>

Parameters

$saisie : string: la saisie
$saisies_repertoire : string = 'saisies': = 'saisies'

Return values

array<string|int, mixed>

saisies_lister_categories()

Lister les catégories par défaut, puis les envoyer au pipeline


    
                    saisies_lister_categories() : array<string|int, mixed>

Return values

array<string|int, mixed> —

liste des catégories

saisies_lister_disponibles_par_categories()

Lister les saisies disponibles en les regroupant en catégories


    
                    saisies_lister_disponibles_par_categories([array<string|int, mixed> $options = [] ]) : array<string|int, mixed>

Parameters

$options : array<string|int, mixed> = []: 'saisies_repertoire' => string ('saisies') 'inclure_obsoletes' => bool (false) 'categorie' => string|null|false (false) 'uniquement_sql' => bool (false) pour limiter à celle avec sql

Return values

array<string|int, mixed>

saisies_lister_disponibles_sql_par_categories()

Liste par catégorie les saisies disponibles ayant une définition SQL


    
                    saisies_lister_disponibles_sql_par_categories([array<string|int, mixed> $options = [] ]) : mixed

Parameters

$options : array<string|int, mixed> = []: voir saisies_lister_disponibles_par_categories return array

saisies_regrouper_disponibles_par_categories()

Regroupe par categories les saisies


    
                    saisies_regrouper_disponibles_par_categories([array<string|int, mixed> $saisies = [] ][, string|null $categorie_demande = null ]) : array<string|int, mixed>

Parameters

$saisies : array<string|int, mixed> = []
$categorie_demande : string|null = null: pour ne renvoyer que cette catégorie

Return values

array<string|int, mixed>

saisies_lister_disponibles_par_categories_usort()

Function de comparaison pour trier les saisies disponibles par rang Si pas de rang défini, on met après ceux avec rang Si deux saisies avec le même rang, on se rabat sur l'ordre alpha


    
                    saisies_lister_disponibles_par_categories_usort(mixed $saisie1, mixed $saisie2) : int

Parameters

$saisie1 : mixed
$saisie2 : mixed

Return values

int

saisies_supprimer()

Supprimer une saisie dont on donne l'identifiant, le nom ou le chemin.


    
                    saisies_supprimer(array<string|int, mixed> $saisies, string|array<string|int, mixed> $id_ou_nom_ou_chemin) : array<string|int, mixed>

Parameters

$saisies : array<string|int, mixed>: Tableau des descriptions de saisies
$id_ou_nom_ou_chemin : string|array<string|int, mixed>: L'identifiant unique ou le nom de la saisie à supprimer ou son chemin sous forme d'une liste de clés

Return values

array<string|int, mixed> —

Tableau modifié décrivant les saisies

saisies_inserer()

Insère une saisie à une position donnée dans un tableau de donnée - soit en lui passant un chemin - soit en lui passant une saisie devant laquelle se placer


    
                    saisies_inserer(array<string|int, mixed> $saisies, array<string|int, mixed> $saisie[, array<string|int, mixed>|string $id_ou_nom_ou_chemin = [] ]) : array<string|int, mixed>

Parameters

$saisies : array<string|int, mixed>

Tableau des descriptions de saisies

$saisie : array<string|int, mixed>

Description de la saisie à insérer

$id_ou_nom_ou_chemin : array<string|int, mixed>|string = []

Si array c'est un chemin Position complète où insérer la saisie - Si directement à la racine du tableau : array(<index_où_inserer>) - Si au sein d'un fieldset ou assimilé : array(<index_du _fieldset>, 'saisies', <index_où_inserer_au_sein_du_fieldset>)
Si string
- Si entre crochets, ca veut dire qu'on insère à la fin d'un fieldset [fieldset]
- Si entre crochets, suivis d'un entier entre crochet, on insère à une position données dans le fieldset [fieldset][0]
- Si pas de crochet, on insère avant la saisie saisie
En absence, insère la saisie à la fin.

Return values

array<string|int, mixed> —

Tableau des saisies complété de la saisie insérée

saisies_inserer_avant()

Insère une saisie avant une autre saisie.


    
                    saisies_inserer_avant(array<string|int, mixed> $saisies, array<string|int, mixed> $saisie, array<string|int, mixed> $id_ou_nom_ou_chemin) : array<string|int, mixed>

Parameters

$saisies : array<string|int, mixed>: Tableau des descriptions de saisies
$saisie : array<string|int, mixed>: Description de la saisie à insérer
$id_ou_nom_ou_chemin : array<string|int, mixed>: identifiant ou nom ou chemin de la saisie devant laquelle inserer

Return values

array<string|int, mixed> —

Tableau des saisies complété de la saisie insérée

saisies_inserer_apres()

Insère une saisie après une autre saisie.


    
                    saisies_inserer_apres(array<string|int, mixed> $saisies, array<string|int, mixed> $saisie, array<string|int, mixed> $id_ou_nom_ou_chemin) : array<string|int, mixed>

Parameters

$saisies : array<string|int, mixed>: Tableau des descriptions de saisies
$saisie : array<string|int, mixed>: Description de la saisie à insérer
$id_ou_nom_ou_chemin : array<string|int, mixed>: identifiant ou nom ou chemin de la saisie derrière laquelle inserer

Return values

array<string|int, mixed> —

Tableau des saisies complété de la saisie insérée

saisies_inserer_selon_chemin()

Insère une saisie à une position donnée, en lui passant un chemin.


    
                    saisies_inserer_selon_chemin(array<string|int, mixed> $saisies, array<string|int, mixed> $saisie[, array<string|int, mixed> $chemin = [] ]) : array<string|int, mixed>

Parameters

$saisies : array<string|int, mixed>

Tableau des descriptions de saisies

$saisie : array<string|int, mixed>

Description de la saisie à insérer

$chemin : array<string|int, mixed> = []

Position complète où insérer la saisie

Si directement à la racine du tableau : array(<index_où_inserer>)
Si au sein d'un fieldset ou assimilé : array(<index_du _fieldset>, 'saisies', <index_où_inserer_au_sein_du_fieldset>) En absence, insère la saisie à la fin.

Return values

array<string|int, mixed> —

Tableau des saisies complété de la saisie insérée

saisies_dupliquer()

Duplique une saisie (ou groupe de saisies) en placant la copie à la suite de la saisie d'origine.


    
                    saisies_dupliquer(array<string|int, mixed> $saisies, unknown_type $id_ou_nom_ou_chemin) : array<string|int, mixed>

Modifie automatiquement les identifiants des saisies.

Parameters

$saisies : array<string|int, mixed>: Un tableau décrivant les saisies
$id_ou_nom_ou_chemin : unknown_type: L'identifiant unique ou le nom ou le chemin de la saisie a dupliquer

Return values

array<string|int, mixed> —

Retourne le tableau modifié des saisies

saisies_deplacer()

Déplace une saisie existante autre part.


    
                    saisies_deplacer(array<string|int, mixed> $saisies, unknown_type $id_ou_nom_ou_chemin, string $ou[, string $avant_ou_apres = 'avant' ]) : array<string|int, mixed>

Parameters

$saisies : array<string|int, mixed>

Un tableau décrivant les saisies

$id_ou_nom_ou_chemin : unknown_type

L'identifiant unique ou le nom ou le chemin de la saisie à déplacer

$ou : string

Le nom de la saisie devant laquelle on déplacera
OU le nom d'un conteneur entre crochets [conteneur] (et dans ce cas on déplace à la fin de conteneur)
OU le nom d'un conteneur entre crochets suivi d'un identifiant numérique entre crochets [conteneur][x] (et dans ce cas on déplace à la position x au sein du conteneur)

$avant_ou_apres : string = 'avant'

(optionel) : valeur possible : 'avant' ou 'apres', pour inserer respectivent avant/après la saisie $ou

Return values

array<string|int, mixed> —

Retourne le tableau modifié des saisies

saisies_deplacer_avant()

Déplacer une saisie existante avant une autre


    
                    saisies_deplacer_avant(array<string|int, mixed> $saisies, unknown_type $id_ou_nom_ou_chemin, string $ou) : array<string|int, mixed>

Parameters

$saisies : array<string|int, mixed>: Un tableau décrivant les saisies
$id_ou_nom_ou_chemin : unknown_type: L'identifiant unique ou le nom ou le chemin de la saisie à déplacer
$ou : string: la saisie devant laquelle déplacer

Return values

array<string|int, mixed> —

$string

saisies_deplacer_apres()

Déplacer une saisie existante après une autre


    
                    saisies_deplacer_apres(array<string|int, mixed> $saisies, unknown_type $id_ou_nom_ou_chemin, string $ou) : array<string|int, mixed>

Parameters

$saisies : array<string|int, mixed>: Un tableau décrivant les saisies
$id_ou_nom_ou_chemin : unknown_type: L'identifiant unique ou le nom ou le chemin de la saisie à déplacer
$ou : string: la saisie devant laquelle déplacer

Return values

array<string|int, mixed> —

$string

saisies_modifier()

Modifie une saisie.


    
                    saisies_modifier(array<string|int, mixed> $saisies, array<string|int, mixed>|string $id_ou_nom_ou_chemin, array<string|int, mixed> $modifs[, bool $fusion = false ]) : array<string|int, mixed>

Parameters

$saisies : array<string|int, mixed>: Un tableau décrivant les saisies
$id_ou_nom_ou_chemin : array<string|int, mixed>|string: L'identifiant unique ou le nom ou le chemin de la saisie à modifier
$modifs : array<string|int, mixed>: Le tableau des modifications à apporter à la saisie
$fusion : bool = false: True si on veut simplifier rajouter des choses, sans tout remplacer

Return values

array<string|int, mixed> —

Retourne le tableau décrivant les saisies, mais modifié

saisies_transformer_noms()

Transforme tous les noms du formulaire avec un preg_replace.


    
                    saisies_transformer_noms(array<string|int, mixed> $saisies, string $masque, string $remplacement) : array<string|int, mixed>

Parameters

$saisies : array<string|int, mixed>: Un tableau décrivant les saisies
$masque : string: Ce que l'on doit chercher dans le nom
$remplacement : string: Ce par quoi on doit remplacer

Return values

array<string|int, mixed> —

Retourne le tableau modifié des saisies

saisies_encapsuler_noms()

Transforme tous les noms en les encapsulant avec un préfixe.


    
                    saisies_encapsuler_noms(array<string|int, mixed> $saisies, string $prefixe[, bool $recursif = true ]) : array<string|int, mixed>

Cela permet d'avoir toutes les valeurs postées dans un unique tableau. Après transformation, on pourra faire _request(<prefixe>) pour les récupérer.

Utilisation possible : on mélange les saisies de plusieurs formulaires, et on a dans ce cas besoin de cloisonner les valeurs.

Parameters

$saisies : array<string|int, mixed>: Un tableau décrivant les saisies
$prefixe : string: Préfixe
$recursif : bool = true: Pour procéder récursivement dans les fieldsets

Return values

array<string|int, mixed>

saisies_transformer_option()

Transforme toutes les options textuelles d'un certain nom, avec un preg_replace.


    
                    saisies_transformer_option(mixed $saisies, mixed $option, mixed $masque, mixed $remplacement[, bool $recursif = true ]) : array<string|int, mixed>

Parameters

$saisies : mixed: Tableau décrivant les saisies
$option : mixed: Nom de l'option à transformer (par ex "nom", ou "afficher_si"), ou tableau Note : si l'option n'existe pas, elle est automatiquement mise à '' avant toute transformation
$masque : mixed: Ce que l'on doit chercher dans le texte
$remplacement : mixed: Ce par quoi on doit remplacer
$recursif : bool = true

Return values

array<string|int, mixed> —

Retourne le tableau modifié des saisies

saisies_mapper_option()

Modifie toutes les options d'un certain nom, avec une fonction de rappel.


    
                    saisies_mapper_option(array<string|int, mixed> $saisies, string|array<string|int, mixed> $options, string $callback[, array<string|int, mixed> $args = [] ][, bool $recursif = true ]) : array<string|int, mixed>

Parameters

$saisies : array<string|int, mixed>: Tableau décrivant les saisies
$options : string|array<string|int, mixed>: Nom de l'option à transformer (par ex "nom", ou "afficher_si") Ou tableau de noms Note : si l'option n'existe pas, elle est automatiquement mise à '' avant toute transformation
$callback : string: Nom de la fonction à appliquer
$args : array<string|int, mixed> = []: Arguments de la fonction de rappel La valeur de l'option est passée automatiquement en premier
$recursif : bool = true: =True

Return values

array<string|int, mixed> —

Retourne le tableau modifié des saisies

saisies_supprimer_option()

Supprime toutes les options d'un certain nom.


    
                    saisies_supprimer_option(mixed $saisies, mixed $option[, bool $recursif = true ]) : array<string|int, mixed>

Parameters

$saisies : mixed: Tableau décrivant les saisies
$option : mixed: Nom de l'option à supprimer (par ex "nom", ou "afficher_si")
$recursif : bool = true

Return values

array<string|int, mixed> —

Retourne le tableau modifié des saisies

saisies_mapper_verifier()

Modifie les vérifications des saisies avec une fonction de rappel


    
                    saisies_mapper_verifier(array<string|int, mixed> $saisies, string $callback[, array<string|int, mixed> $args = [] ][, bool $recursif = true ]) : array<string|int, mixed>

Parameters

$saisies : array<string|int, mixed>

Tableau décrivant les saisies

$callback : string

Nom de la fonction à appliquer, elle doit retourner la nouvelle version du tableau de vérification

Les vérifs telles que disponibles actuellement sont passées en premier (on modifie donc l'ensemble des vérifications, charge à la fonction de rappel de choisir quelle vérification modifier). Toutefois le tableau de vérification est normalisé pour utiliser uniquement la "nouvelle" syntaxe permettant d'avoir plusieurs vérifications
La description complète de la saisie est passée en second

$args : array<string|int, mixed> = []

Arguments supplémentaires passées à la fonction de rappel

$recursif : bool = true

=True

Return values

array<string|int, mixed> —

Retourne le tableau modifié des saisies

saisies_transformer_noms_auto()

Transforme les noms d'une liste de saisies pour qu'ils soient uniques dans le formulaire donné.


    
                    saisies_transformer_noms_auto(array<string|int, mixed> $formulaire, array<string|int, mixed> $saisies) : array<string|int, mixed>

Parameters

$formulaire : array<string|int, mixed>: Le formulaire à analyser
$saisies : array<string|int, mixed>: Un tableau décrivant les saisies.

Return values

array<string|int, mixed> —

Retourne le tableau modifié des saisies

saisies_inserer_html()

Insère du HTML au début ou à la fin d'une saisie.


    
                    saisies_inserer_html(array<string|int, mixed> $saisie, string $insertion[, string $ou = 'fin' ]) : array<string|int, mixed>

Parameters

$saisie : array<string|int, mixed>: La description d'une seule saisie
$insertion : string: Du code HTML à insérer dans la saisie
$ou : string = 'fin': L'endroit où insérer le HTML : "debut" ou "fin"

Return values

array<string|int, mixed> —

Retourne la description de la saisie modifiée

saisies_fieldsets_en_onglets()

Ajoute l'option onglet aux fieldset de premier niveau dans un tableau de $saisie Ajoute également un identifiant unique, éventuellement préfixé


    
                    saisies_fieldsets_en_onglets(array<string|int, mixed> $saisies[, string $identifiant_prefixe = '' ][, bool $vertical = false ]) : array<string|int, mixed>

Parameters

$saisies : array<string|int, mixed>
$identifiant_prefixe : string = ''
$vertical : bool = false

Return values

array<string|int, mixed> —

$saisies modifiées

saisies_supprimer_sans_reponse()

Prend un tableau de saisies Enlève les saisies qui n'ont rien dans _request Ou dont l'ensemble des sous-saisies sont vides


    
                    saisies_supprimer_sans_reponse(array<string|int, mixed> $saisies[, optional $tableau = null ]) : array<string|int, mixed>

Parameters

$saisies : array<string|int, mixed>
$tableau : optional = null: (tableau pour chercher dans request)

Return values

array<string|int, mixed>

saisies_saisie_possede_reponse()

Indique si une saisie possède une réponse


    
                    saisies_saisie_possede_reponse(array<string|int, mixed> $saisie[, null|array<string|int, mixed> $tableau = null ]) : bool

Parameters

$saisie : array<string|int, mixed>: la saisie individuelle
$tableau : null|array<string|int, mixed> = null: (tableau pour chercher les valeurs, à défaut request

Return values

bool

saisies_supprimer_depublie()

Prend un tableau de saisies Enlève les saisies dépubliées Ou dont l'ensemble des sous-saisies sont dépubliés


    
                    saisies_supprimer_depublie(array<string|int, mixed> $saisies) : array<string|int, mixed>

Parameters

$saisies : array<string|int, mixed>

Return values

array<string|int, mixed>

saisies_supprimer_depublie_sans_reponse()

Prend un tableau de saisies Enlève les saisies dépubliées Et qui n'ont pas de réponse Ou dont l'ensemble des saisies répondent au critère ci-dessus


    
                    saisies_supprimer_depublie_sans_reponse(array<string|int, mixed> $saisies[, array<string|int, mixed>|null $reponses = null ]) : array<string|int, mixed>

Parameters

$saisies : array<string|int, mixed>
$reponses : array<string|int, mixed>|null = null: null pour chercher dans _request

Return values

array<string|int, mixed>

saisies_supprimer_callback()

Prend un tableau de saisies supprime les saisies selon une fonction de rappel


    
                    saisies_supprimer_callback(array<string|int, mixed> $saisies, callable $callback) : array<string|int, mixed>

Parameters

$saisies : array<string|int, mixed>: tableau de saisies
$callback : callable: fonction de rappel la fonction doit renvoyer true si on garde, false sinon

Return values

array<string|int, mixed>

saisies_wrapper_fieldset()

Transforme un tableau de saisies en englobant le tout dans un fieldset utilisé pour la prévisualisation


    
                    saisies_wrapper_fieldset(array<string|int, mixed> $saisies, array<string|int, mixed> $options) : array<string|int, mixed>

Parameters

$saisies : array<string|int, mixed>
$options : array<string|int, mixed>: du fieldset

Return values

array<string|int, mixed>

saisies_migrer_afficher_si_remplissage()

Parcours un tableau de saisies, regarde si on a un champ afficher_si_remplissage et le transforme en champs afficher_si + afficher_si_remplissage_uniquement


    
                    saisies_migrer_afficher_si_remplissage(array<string|int, mixed> $saisies) : array<string|int, mixed>

Parameters

$saisies : array<string|int, mixed>: Les saisies initiales

Return values

array<string|int, mixed> —

$saisies Les saisies modifiées

construire_configuration_saisie()


    
                    construire_configuration_saisie(mixed $saisie[, mixed $avec_nom = 'non' ]) : mixed

Parameters

$saisie : mixed
$avec_nom : mixed = 'non'

conteneur_inline_est_avec_sous_saisies()

Un conteneur_inline, c'est une saisie contenante


    
                    conteneur_inline_est_avec_sous_saisies(array<string|int, mixed> $saisie) : bool

Parameters

$saisie : array<string|int, mixed>

Return values

bool —

true

conteneur_inline_est_labelisable()

Un conteneur_inline, ca n'a pas de label


    
                    conteneur_inline_est_labelisable(array<string|int, mixed> $saisie) : bool

Parameters

$saisie : array<string|int, mixed>

Return values

bool —

false

conteneur_inline_est_champ()

Un conteneur_inline, ca n'est pas un champ


    
                    conteneur_inline_est_champ(array<string|int, mixed> $saisie) : bool

Parameters

$saisie : array<string|int, mixed>

Return values

bool —

false

explication_est_champ()

Une explication, ca n'est pas un champ


    
                    explication_est_champ(array<string|int, mixed> $saisie) : bool

Parameters

$saisie : array<string|int, mixed>

Return values

bool —

false

explication_get_label()

Retourne le label de la saisie `explication` Par ordre de priorité le `titre` sinon le `texte`


    
                    explication_get_label(array<string|int, mixed> $saisie) : string

Parameters

$saisie : array<string|int, mixed>

Return values

string

fieldset_est_avec_sous_saisies()

Un fieldset, c'est une saisie contenante


    
                    fieldset_est_avec_sous_saisies(array<string|int, mixed> $saisie) : bool

Parameters

$saisie : array<string|int, mixed>

Return values

bool —

true

fieldset_est_champ()

Un fieldset, ca n'est pas un champ


    
                    fieldset_est_champ(array<string|int, mixed> $saisie) : bool

Parameters

$saisie : array<string|int, mixed>

Return values

bool —

false

remplir_tableau_mime()

Remplit un tableau de description de types mime Sous la forme type_mime => 'Nom du type (extensions)'


    
                    remplir_tableau_mime(array<string|int, mixed> $tableau, string $mime, string $titre, string $extension) : array<string|int, mixed>

Parameters

$tableau : array<string|int, mixed>: le tableau en l'état actuel
$mime : string: le type mime qu'on veut mettre à jour
$titre : string: le titre associé au type mime
$extension : string: une extension associé au type mime

Return values

array<string|int, mixed> —

le tableau modifié

verifier_afficher_si_dist()


    
                    verifier_afficher_si_dist(string $valeur) : string

Parameters

$valeur : string: La valeur à vérifier.

Return values

string —

Retourne une chaine vide si c'est valide, sinon une chaine expliquant l'erreur.

verifier_saisies_option_data_dist()

Vérifier qu'une saisie est sous forme d'une chaine transformable en tableau de data C'est-à-dire de la forme cle|valeur Et ce en autorisant les sous-groupes (sauf si demande contraire) Mais en refusant les clés construite automatiquement pour des lignes sans pipe.


    
                    verifier_saisies_option_data_dist(string $valeur[, mixed $options = [] ]) : string

On en profite pour vérifier qu'il n'y pas de clé en double. De plus les trim() pertubent les choses.

Parameters

$valeur : string: La valeur à vérifier.
$options : mixed = []: interdire_sous_groupes => True|False verifier_cles => array décrivant une vérification à effectuer

Return values

string —

Retourne une chaine vide si c'est valide, sinon une chaine expliquant l'erreur.

verifier_valeurs_acceptables_dist()


    
                    verifier_valeurs_acceptables_dist(string $valeur, array<string|int, mixed> $options) : string

Parameters

$valeur : string: La valeur à vérifier.
$options : array<string|int, mixed>: les options de vérification

Return values

string —

Retourne une chaine vide si c'est valide, sinon une chaine expliquant l'erreur.

Application

Table of Contents

Functions

Functions

champs_extras_calculer_balise_LISTER_VALEURS_choix_grille()

Parameters

Return values

champs_extras_serialiser_choix_grille()

Parameters

Return values

formulaires_configurer_saisies_saisies_dist()

Return values

formulaires_construire_formulaire_charger()

Parameters

Return values

formulaires_construire_formulaire_verifier()

Parameters

formulaires_construire_formulaire_traiter()

Parameters

construire_formulaire_generer_saisie_configurable()

Parameters

Return values

saisies_groupe_inserer()

Parameters

construire_formulaire_config_inserer_option_depublie()

Parameters

Return values

formulaires_saisies_cvt_saisies_dist()

formulaires_saisies_cvt_charger()

saisie_editable()

Parameters

Return values

saisies_generer_html()

Parameters

Return values

saisies_generer_vue()

Parameters

Tags

Return values

saisies_trouver_erreur()

Parameters

Return values

saisies_afficher_normaliser_options_attributs()

Parameters

Return values

saisies_saisie_est_tabulaire()

Parameters

Return values

saisies_saisie_est_fichier()

Parameters

Return values

saisies_saisie_est_gelee()

Parameters

Return values

saisies_verifier_gel_saisie()

Parameters

Return values

saisies_saisie_est_avec_sous_saisies()

Parameters

Return values

saisies_saisie_est_labelisable()

Parameters

Return values

saisies_saisie_est_champ()

Parameters

Return values

saisies_saisie_get_label()

Parameters

Return values

saisies_lister_par_identifiant()

Parameters

Return values

saisies_lister_par_nom()

Parameters

Return values

saisies_lister_finales()

Parameters

Return values

saisies_lister_avec_option()

Parameters