-
Notifications
You must be signed in to change notification settings - Fork 15
/
readme.txt
executable file
·201 lines (129 loc) · 5.35 KB
/
readme.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
=== Plugin Name ===
Contributors: tusko-trush
Donate link: https://donatua.com/@tusko
Tags: Advanced Custom Fields, ACF Options, Custom Post Type, Archive
Requires at least: 3.0
Tested up to: 6.2
Stable tag: 2.0.9
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html
Small addon for ACF Options. Adds ACF location for each custom post type.
**New feature** in the major version 2!<br>
<span style="color:red">Important!</span><br>
**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.
== Description ==
Small addon for ACF Options. Adds ACF location for each custom post type.
**New feature** in the major version 2!<br>
<span style="color:red">Important!</span><br>
**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](http://www.advancedcustomfields.com/ "Advanced Custom Fields") (`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](http://www.advancedcustomfields.com/resources/shortcode/ "ACF Shortcode")
## 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 =
[Support plugin](https://donatua.com/@tusko)
= License =
Copyright (c) 2023, [Tusko Trush](https://frontend.im/?github "Front-End Developer")
= Requirements =
You must buy ACF PRO or ACF Options Page Addon.
= Translation =
**qTranslate-XT**
This plugin is compatible and has included [ACF qTranslate](https://uk.wordpress.org/plugins/acf-qtranslate/ "ACF qTranslate").
Just enjoy!
**qTranslate-X**
If you are using Qtranslate-X, you must install [ACF qTranslate](https://uk.wordpress.org/plugins/acf-qtranslate/ "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)`.
== Installation ==
1. Upload 'acf-cpt-options-pages' to the `/wp-content/plugins/` directory.
2. Activate the plugin through the`Plugins` 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.
== Frequently Asked Questions ==
If you have any questions on this please post an issue/question at [Github Issues](https://github.com/Tusko/ACF-CPT-Options-Pages/issues)
== Screenshots ==
1. assets/screenshot-1.png
== 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.
== Upgrade Notice ==
= 1.0.2 =
* Update documentation.
* Change labels and slugs.