Description
Small addon for ACF Options. Adds ACF location for each custom post type.
New feature in the major version 2!
Important!
After update to v2+ you must reconnect Field Groups to Options Pages
Now you can activate/deactivate CPTs and create custom options pages for each CPT.
By default, options pages are activated for all custom post types.
Usage
The default functions of ACF plugin (get_field, the_field, etc.
) can be used to load values from a CPT Options Pages, but second parameter is required to target the CPT options.
This is similar to passing through a $post_id
parameter to target a specific post object.
The $post_id
parameter needed is a string containing the cpt_
and CPT name in the following format; "cpt_{CPT_NAME}"
and for subpages you can copy generated ID while creating subpages.
Examples
In examples Custom Post Type name is
projects
.
So, let’s go!
Display a field
<p><?php the_field('field_name', 'cpt_projects'); ?></p>
and the subpage’s field
<p><?php the_field('field_name', 'cpt_projects_testpage'); ?></p>
Retrieve a field
<?php
$field = get_field('field_name', 'cpt_projects');
// do something with $field
?>
Display a sub field
<?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; ?>
Display with shortcode
[acf field="field_name" post_id="cpt_projects"]
Please read documentation about shortcodes with ACF
Customization
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');
Don’t forget to replace cpt_projects_
to your custom post type name 🙂
It works only for first level options pages, not for subpages.
Donate
License
Copyright (c) 2023, Tusko Trush
Requirements
You must buy ACF PRO or ACF Options Page Addon.
Translation
qTranslate-XT
This plugin is compatible and has included ACF qTranslate.
Just enjoy!
qTranslate-X
If you are using Qtranslate-X, you must install ACF qTranslate.
WPML/Polylang
If you are using WPML or Polylang, you must add constant ICL_LANGUAGE_CODE
to post_id
,
for example: get_field('archive_title', 'cpt_projects_' . ICL_LANGUAGE_CODE)
.
Screenshots
Installation
- Upload ‘acf-cpt-options-pages’ to the
/wp-content/plugins/
directory. - Activate the plugin through the
Plugins
menu in WordPress. - Go to
Custom fields
submenuCPT Options page
and activate CPTs what you need or create subpages for that. - Create your Custom Field Group, set location rule
Options Page
and choose your CPT options page or subpage. - Read the documentation to display your data.
FAQ
If you have any questions on this please post an issue/question at Github Issues
Reviews
Contributors & Developers
“Advanced Custom Fields : CPT Options Pages” is open source software. The following people have contributed to this plugin.
Contributors“Advanced Custom Fields : CPT Options Pages” has been translated into 3 locales. Thank you to the translators for their contributions.
Translate “Advanced Custom Fields : CPT Options Pages” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
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.