Mô tả
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)
.
Ảnh màn hình
Cài đặt
- 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.
Hỏi đáp
If you have any questions on this please post an issue/question at Github Issues
Đánh giá
Người đóng góp & Lập trình viên
“Advanced Custom Fields : CPT Options Pages” là mã nguồn mở. Những người sau đã đóng góp vào plugin này.
Những người đóng góp“Advanced Custom Fields : CPT Options Pages” đã được dịch qua 3 ngôn ngữ. Cảm ơn những người tham gia dịch vì đóng góp của họ.
Dịch “Advanced Custom Fields : CPT Options Pages” sang ngôn ngữ của bạn.
Muốn tham gia phát triển?
Duyệt code, check out SVN repository, hoặc theo dõi nhật ký phát triển qua RSS.
Nhật ký thay đổi
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.