Advanced Custom Fields : CPT Options Pages

Description

Petit module pour les options ACF. Ajoute un emplacement ACF pour chaque type de publication personnalisé.

Nouvelle fonctionnalité dans la version majeure 2 !
Important !
Après la mise à jour en v2 et plus vous devez reconnecter les groupes de champs aux pages d’options

Maintenant vous pouvez activer/désactiver les CPT et créer des pages d’options personnalisées pour chaque CPT.
Par défaut, les pages d’options sont activées pour tous les types de publication personnalisés.

Utilisation

Les fonctions par défaut de l’extension ACF (en anglais) (get_field, the_field, etc.) peuvent être utilisées pour charger les valeurs en provenance d’une page d’options d’un CPT, mais le second paramètre est nécessaire pour cibler les options du CPT.

This is similar to passing through a $post_id parameter to target a specific post object.

Le paramètre $post_id requis est une chaîne contenant cpt_ et le nom du CPT dans le format suivant ; "cpt_{NOM_CPT}" et pour les sous-pages vous pouvez copier l’ID généré à la création des sous-pages.

Exemples

Dans les exemples le nom du type de publication personnalisée est projects.

Alors allons-y !

Afficher un champ

<p><?php the_field('field_name', 'cpt_projects'); ?></p>

et le champ de la sous-page

<p><?php the_field('field_name', 'cpt_projects_testpage'); ?></p>

Récupérer un champ

<?php
    $field = get_field('field_name', 'cpt_projects');
    // do something with $field
?>

Afficher un sous-champ

    <?php if( have_rows('repeater_name', 'cpt_projects') ): ?>
        <ul>
            <?php while( have_rows('repeater_name', 'cpt_projects') ): the_row(); ?>
                <li><?php the_sub_field('the_title'); ?></li>
            <?php endwhile; ?>
        </ul>
    <?php endif; ?>

Afficher avec un code court

[acf field="field_name" post_id="cpt_projects"]

Veuillez lire la documentation sur les codes courts avec ACF (en anglais)

Personnalisation

    function cpt_projects_customize($cptmenu) {
        $cptmenu['page_title'] = 'Dev Custom title';
        $cptmenu['menu_title'] = 'Dev Custom title';
        return $cptmenu;
    }

    add_filter('cpt_projects_acf_page_args', 'cpt_projects_customize');

N’oubliez pas de remplacer cpt_projects_ par le nom de votre type de publication personnalisé 🙂
Cela fonctionne uniquement pour le premier niveau des pages d’options, pas pour les sous-pages.

Donate

Support plugin

Licence

Copyright (c) 2023, Tusko Trush

Prérequis

Vous devez acheter ACF PRO ou le module de page d’options.

Translation

qTranslate-XT

This plugin is compatible and has included ACF qTranslate.
Just enjoy!

qTanslate-X

Si vous utilisez Qtranslate-X, vous devez installer ACF qTranslate.

WPML/Polylang

Si vous utilisez WPML ou Polylang, vous devez ajouter la constante ICL_LANGUAGE_CODE à post_id,
par exemple : get_field('archive_title', 'cpt_projects_' . ICL_LANGUAGE_CODE).

Captures d’écran

  • assets/screenshot-1.png

Installation

  1. Upload ‘acf-cpt-options-pages’ to the /wp-content/plugins/ directory.
  2. Activate the plugin through thePlugins menu in WordPress.
  3. Go to Custom fields submenu CPT Options page and activate CPTs what you need or create subpages for that.
  4. Create your Custom Field Group, set location rule Options Page and choose your CPT options page or subpage.
  5. Read the documentation to display your data.

FAQ

Si vous avez des questions veuillez publier une issue/question sur Issues Github (en anglais)

Avis

18 février 2020
The great plugin which I have been looking for a long time!! The great plugin which I have been looking for a long time!! It works easy and awesome!
1 juillet 2017
I did not know that such a basic plugin can be there that lets me create the options page with such ease.
16 novembre 2016 1 réponse
Smart, intuitive and works exactly as advertised. Just what I needed for archive pages custom headings but I'm certain I will find other ways of using this excellent tool.
Lire les 7 avis

Contributeurs/contributrices & développeurs/développeuses

« Advanced Custom Fields : CPT Options Pages » est un logiciel libre. Les personnes suivantes ont contribué à cette extension.

Contributeurs

“Advanced Custom Fields : CPT Options Pages” a été traduit dans 3 locales. Remerciez l’équipe de traduction pour ses contributions.

Traduisez « Advanced Custom Fields : CPT Options Pages » dans votre langue.

Le développement vous intéresse ?

Parcourir le code, consulter le SVN dépôt, ou s’inscrire au journal de développement par RSS.

Journal

2.0.9

  • Tested up with WP 6.2 and ACF Pro 6.1.3

2.0.8

  • Tested up with WP 5.8.1 and ACF Pro 5.10.2
  • Fix lang switcher and Wysiwyg Editor capability on ACF CPT Options pages
  • Modified page slug ‘-options’ -> ‘acfcpt-options’ to make qTranslate config regex

2.0.7

  • Tested up 5.7.2
  • @Ekeler PR: Update class.acf-cpt-options-pages.php

2.0.6

  • Tested up 5.7.1
  • Added apply_filters cpt_options_post_types_params

2.0.5

  • Tested up 5.3.2
  • Fix donate links

2.0.4

  • Tested up 5.2.1
  • Assets updated

2.0.3

  • Fixed underscores in options pages title

2.0.2

  • Fixed WPML slugs

2.0.0

  • Added Russian, Ukrainian translations.
  • Added setting page to ACF CPT Options Pages
  • Added UI to manage options pages per CPT
  • Ability to add child pages to CPTs

1.1.0

  • Support MO translations
  • Customization using add_filter

1.1.0

  • WPML and Polylang compatibility added.

1.0.2

  • Update documentation.
  • Change labels and slugs.

1.0.1

  • Plugin created.