Ce n'apply_filters(...) en fait faire dans WordPress?

J'essaie de comprendre certains de la fonction dans WordPress, mais je ne peux pas obtenir ma tête autour de ce qui apply_filters(...) la réalité.

Est quelqu'un capable de les éclaircir ce point pour moi, avec quelques exemples?

  • Génial: dev.themeblvd.com/tutorial/filters
  • A noter que apply_filters() est incroyablement trompeur nom de la fonction en tant qu'il s'applique à la fois les filtres et les actions accroché à la fonction cible
  • très bonne suggestion, dev.themeblvd.com/tutorial/filters/#highlighter_604585, mais lorsque cette fonction n'accepte pas d'arguments(veuillez cliquer sur le lien pour voir quelle fonction je parle), comment est l' $variable de sortie modifié , comme il le décrit dans son code suivant dans la section?
  • Vous êtes le lien ne semble pas fonctionner comme prévu, veuillez utiliser Github gist.
  • désolé! Veuillez défiler vers le bas pour Exemple 1: Les Bases sur cette page.
InformationsquelleAutor Tim | 2010-02-16
  1. 102

    apply_filters($tag, $value) passe de la "valeur" de l'argument de chacune des fonctions "accroché" (à l'aide de add_filter) dans le filtre spécifié 'tag'. Chaque fonction effectue un traitement sur la valeur et renvoie une valeur modifiée à passer à la fonction suivante dans la séquence.

    Par exemple, par défaut (dans WordPress 2.9) le the_content filtre passe la valeur à travers la séquence suivante de fonctions:

    • wptexturize
    • convert_smilies
    • convert_chars
    • wpautop
    • shortcode_unautop
    • prepend_attachment
    • do_shortcode
    • Rappelez-vous aussi faire écho à quelque chose que vous n'êtes pas en utilisant la valeur de si il semble que apply_filters($value) s'en prend à une valeur...
    InformationsquelleAutor Richard M
  2. 26

    réponse tardive

    Courte explication

    apply_filters() interagit avec le global $wp_filters tableau. Fondamentalement, il vérifie juste le tableau si le filtre en cours (ou crochet) a une action(/fonction de rappel), joint, puis l'appelle.

    Longue explication

    Lorsque vous attachez un rappel/l'action d'un filtre ou d'un crochet, puis il suffit d'ajouter le nom de rappel global tableau de filtres. Lorsque, dans le code (par exemple, un modèle de base ou fichier de plugin) un appel à do_action() ou apply_filters() qui se passe, puis WordPress recherché à travers le tableau et appelle le callback. La seule chose de plus spécial avec les filtres qu'avec des crochets, c'est qu'elle renvoie la valeur (pour traitement complémentaire) au lieu de la cuisson de la fonction de rappel. Donc résumé: les Crochets sont à insérer de données, tandis que les filtres sont à modifier de données.

    InformationsquelleAutor kaiser
  3. 18

    Voici ce que je suis glanage, après avoir examiné la réponse la plus populaire et ressources supplémentaires:

    • $tag semble être un synonyme pour le nom de l'hameçon. (Qui n'est pas particulièrement intuitif pour moi.)
    • the_content est un exemple d'un crochet, de la "filtre" type de.
    • the_content crochet se compose de plusieurs filtres.
    • Filtres de modifier les données. Ils se sont contentés de filtrer la base de données, la modification de données avant que les utilisateurs de l'afficher.
    • Une utilisation commune de apply_filters(), par exemple, est d'appliquer the_content filtres à $contenu. Dans cet exemple, la double retourne se convertir à <p> des balises, des visages souriants se convertir à des icônes, etc.
    • "the_content" est un crochet, tandis que "the_content()" est une fonction.
    InformationsquelleAutor Marjorie Roswell
  4. 1

    Dans la plupart des conditions de base, apply_filters est utilisée pour initialiser un filtre crochet... add_filter assigne une nouvelle fonction à crochets qui ont déjà été créés.

    • Désolé, c'est la mauvaise voie: apply_filters() appelle le filtre crochets qui sont déjà initialisé et add_filter() est un appel qui crée un filtre crochet. Je sais que vous vouliez vraiment dire cela, mais vous avez les fonctions dans le mauvais sens!
    • apply_filters($tag,$valeur); permet de créer un endroit dans le code où vous pouvez vous permettre ensuite de la valeur en dollars que vous transmettez à être accroché dans et modifiés à l'aide de add_filter();
    InformationsquelleAutor Steve