Package Texte

Sous packages

Fichiers du package

FichierDescription
texte.php

Gestion des textes et raccourcis SPIP

texte_mini.php

Gestion des textes et échappements (fonctions d'usages fréquents)

Proposer une amélioration

Liste des constantes

Valeur

  • 'address|applet|article|aside|blockquote|button|center|d[ltd]|div|fieldset|fig(ure|caption)|footer|form|h[1-6r]|hgroup|head|header|iframe|li|map|marquee|nav|noscript|object|ol|pre|section|t(able|[rdh]|body|foot|extarea)|ul|script|style'

Package

Valeur

  • ',</?(' . _BALISES_BLOCS . ')[>[:space:]],iS'

Package

Valeur

  • ',<(html|code|cadre|frame|script|style)(\s[^>])?>(.)</\1>,UimsS'

Package

Valeur

  • creer_uniqid()

Package

Valeur

  • creer_uniqid()

Package

Valeur

  • ",</?[a-z!][^<>][" . preg_quote(_TYPO_PROTEGER) . "][^<>]>,imsS"

Package

Valeur

  • "\x1\x2\x3\x4\x5\x6\x7\x8"

Package

Valeur

  • "!':;?~%-"

Package

Liste des fonctions

void code_echappement( $rempl , $source = '' , $no_transform = false , $mode = null )

Paramètres

  1. $rempl
  2. $source = ''
  3. $no_transform = false
  4. $mode = null

Package

Proposer une amélioration

Applique les corrections typographiques adaptées à la langue indiquée.

string corriger_typo( string $letexte , string $lang = '' )

Paramètres

  1. string $letexte

    Texte

  2. string $lang = ''

    Langue

Retour

  • string

    Texte

Appelle le pipeline

Package

Proposer une amélioration

Il essaie de ne pas couper les mots et enlève le formatage du texte. Si le texte original est plus long que l’extrait coupé, alors des points de suite sont ajoutés à l'extrait, tel que (...).

string couper( string $texte , integer $taille = 50 , string $suite = null )

Paramètres

  1. string $texte

    Texte à couper

  2. integer $taille = 50

    Taille de la coupe

  3. string $suite = null

    Points de suite ajoutés.

Retour

  • string

    Texte coupé

Package

Note

  • Les points de suite ne sont pas ajoutés sur les extraits très courts.

Filtre

  • couper
Proposer une amélioration

Le nom de l'image est déterminé par la globale 'puce' ou 'puce_prive' ou les mêmes suffixées de '_rtl' pour ce type de langues.

string definir_puce( )

Retour

  • string

    Code HTML de la puce

Package

Note

  • On initialise la puce pour éviter find_in_path() à chaque rencontre de \n- Mais attention elle depend de la direction et de X_fonctions.php, ainsi que de l'espace choisi (public/prive)
Proposer une amélioration
array definir_raccourcis_alineas( )

Retour

  • array

    Tablea ('','')

Package

Proposer une amélioration
void echappe_html( $letexte , $source = '' , $no_transform = false , $preg = '' )

Paramètres

  1. $letexte
  2. $source = ''
  3. $no_transform = false
  4. $preg = ''

Package

Proposer une amélioration

..

string echappe_js( string $t , string $class = ' class = "echappe-js"' )

Paramètres

  1. string $t
  2. string $class = ' class = "echappe-js"'

    Attributs HTML du conteneur à ajouter

Retour

  • string

Package

Proposer une amélioration
void echappe_retour( $letexte , $source = '' , $filtre = "" )

Paramètres

  1. $letexte
  2. $source = ''
  3. $filtre = ""

Package

Proposer une amélioration
void echappe_retour_modeles( $letexte , $interdire_scripts = false )

Paramètres

  1. $letexte
  2. $interdire_scripts = false

Utilisé par

Package

Proposer une amélioration
void echapper_faux_tags( $letexte )

Paramètres

  1. $letexte

Utilisé par

Package

Proposer une amélioration

Sécurité : empêcher l'exécution de code PHP, en le transformant en joli code dans l'espace privé. Cette fonction est aussi appelée par propre et typo.

De la même manière, la fonction empêche l'exécution de JS mais selon le mode de protection passe en argument

Il ne faut pas désactiver globalement la fonction dans l'espace privé car elle protège aussi les balises des squelettes qui ne passent pas forcement par propre ou typo après si elles sont appelées en direct

string interdire_scripts( string $arg , integer $mode_filtre = null )

Paramètres

  1. string $arg

    Code à protéger

  2. integer $mode_filtre = null

    Mode de protection

    -1 : protection dans l'espace privé et public 0 : protection dans l'espace public 1 : aucune protection utilise la valeur de la globale filtrer_javascript si non fourni

Retour

  • string

    Code protégé

Package

Proposer une amélioration

/!\ appelée dans inc/filtres et public/composer

Ne fait rien ici. Voir plugin Textwheel

string paragrapher( string $letexte , null $forcer = true )

Paramètres

  1. string $letexte
  2. null $forcer = true

Retour

  • string

Package

Proposer une amélioration

Filtre à appliquer aux champs du type #TEXTE*

string propre( string $t , string | null $connect = null , array $env = array() )

Paramètres

  1. string $t

    Texte avec des raccourcis SPIP

  2. string | null $connect = null

    Nom du connecteur à la bdd

  3. array $env = array()

    Environnement (pour les calculs de modèles)

Retour

  • string

    $t Texte transformé

Voir également

Utilisé par

Package

Filtre

  • propre
Proposer une amélioration
void protege_js_modeles( $t )

Paramètres

  1. $t

Package

Proposer une amélioration

Échappe le code PHP et JS. Applique en plus safehtml si un plugin le définit dans inc/safehtml.php

Permet de protéger les textes issus d'une origine douteuse (forums, syndications...)

string safehtml( string $t )

Paramètres

  1. string $t

    Texte à sécuriser

Retour

  • string

    Texte sécurisé

Package

Filtre

  • safehtml
Proposer une amélioration

Fonction en cas de texte extrait d'un serveur distant: on ne sait pas (encore) rapatrier les documents joints Sert aussi à nettoyer un texte qu'on veut mettre dans un <a> etc.

string supprime_img( string $letexte , string | null $message = null )

Paramètres

  1. string $letexte

    Texte à nettoyer

  2. string | null $message = null

    Message de remplacement pour chaque image enlevée

Retour

  • string

    Texte sans les modèles d'image

Package

Todo

  • gérer les autres modèles ?
Proposer une amélioration
void traiter_echap_cadre_dist( $regs )

Paramètres

  1. $regs

Package

Proposer une amélioration
void traiter_echap_code_dist( $regs )

Paramètres

  1. $regs

Package

Proposer une amélioration
void traiter_echap_frame_dist( $regs )

Paramètres

  1. $regs

Package

Proposer une amélioration
void traiter_echap_html_dist( $regs )

Paramètres

  1. $regs

Package

Proposer une amélioration
void traiter_echap_script_dist( $regs )

Paramètres

  1. $regs

Package

Proposer une amélioration

Ne fais rien. Voir Plugin Textwheel. (merci a Michael Parienti)

string traiter_listes( string $texte )

Paramètres

  1. string $texte

Retour

  • string

Package

Proposer une amélioration

Ne fais rien ici. Voir plugin Textwheel.

string traiter_raccourcis( string $letexte )

Paramètres

  1. string $letexte

Retour

  • string

Utilisé par

Appelle le pipeline

Package

Proposer une amélioration

Ne sert plus

string traiter_retours_chariots( string $letexte )

Paramètres

  1. string $letexte

    Texte

Retour

  • string

    Texte

Package

Proposer une amélioration

Ne fait rien ici. Voir plugin Textwheel.

string traiter_tableau( string $bloc )

Paramètres

  1. string $bloc

Retour

  • string

Package

Proposer une amélioration

Effectue un traitement pour que les textes affichés suivent les règles de typographie. Fait une protection préalable des balises HTML et SPIP. Transforme les balises <multi>

string typo( string $letexte , boolean $echapper = true , string | null $connect = null , array $env = array() )

Paramètres

  1. string $letexte

    Texte d'origine

  2. boolean $echapper = true

    Échapper ?

  3. string | null $connect = null

    Nom du connecteur à la bdd

  4. array $env = array()

    Environnement (pour les calculs de modèles)

Retour

  • string

    $t Texte transformé

Voir également

Utilisé par

Package

Filtre

  • typo
Proposer une amélioration