This component is a part of the Olympus Dionysos fields for WordPress. It uses a duplicate
findPosts
WordPress custom modal to manage field.
composer require getolympus/olympus-dionysos-field-wordpress
Field initialization • Variables definitions • Texts definition • Accepted types • Retrive data • Release history • Contributing
Use the following lines to add a wordpress field
in your WordPress admin pages or custom post type meta fields:
return \GetOlympus\Dionysos\Field\Wordpress::build('my_wordpress_field_id', [
'title' => 'Which is your favourite post?',
'default' => [],
'description' => 'Tell us which one did like this week.',
'field' => 'ID',
'multiple' => false,
'type' => 'post',
'settings' => [],
/**
* Texts definition
* @see the `Texts definition` section below
*/
't_addblock_title' => 'Click on the edit button',
't_addblock_description' => 'Click on the "+" button to add your item.',
't_addblocks_description' => 'Click on the "+" button to add a new item.',
't_addblock_label' => 'Add',
't_editblock_label' => 'Edit',
't_removeblock_label' => 'Remove',
't_modaltitle_label' => 'Choose a content',
't_modalclose_label' => 'Close',
't_modalsearch_label' => 'Search',
't_modalsubmit_label' => 'Select',
't_ajaxerror_label' => 'No item found',
]);
Variable | Type | Default value if not set | Accepted values |
---|---|---|---|
title |
String | 'Code' |
empty |
default |
Array | empty | empty |
description |
String | empty | empty |
field |
String | ID |
depends on type value |
multiple |
Boolean | false |
true or false |
type |
String | post |
see Accepted types |
settings |
Array | empty | depends on type value |
Notes:
- Set
multiple
totrue
to display checkboxes instead of radio buttons field
variable is used to let you retrieve the data you need, depending ontype
value (for example: in the'type' => 'term'
case, you'll getterm_id
by default)
Code | Default value | Definition |
---|---|---|
t_addblock_title |
Click on the edit button | Used as a notice to help users when there is no label yet |
t_addblock_description |
Click on the "+" button to add your item. | Used as a notice to help users in single format |
t_addblocks_description |
Click on the "+" button to add a new item. | Used as a notice to help users in multiple format |
t_addblock_label |
Add | Add button label |
t_editblock_label |
Edit | Edit button label |
t_removeblock_label |
Remove | Remove button label |
t_modaltitle_label |
Choose a content | Modal title |
t_modalclose_label |
Close | Modal close button label |
t_modalsearch_label |
Search | Modal search button label |
t_modalsubmit_label |
Select | Modal select button label |
t_ajaxerror_label |
No item found | Error message on ajax failure |
categories
orcategory
(seeget_categories
on WordPress reference forfield
andsettings
variables)menus
ormenu
(seewp_get_nav_menus
on WordPress reference forfield
andsettings
variables)pages
orpage
(seeget_pages
on WordPress reference forfield
andsettings
variables)posts
orpost
(seewp_get_recent_posts
on WordPress reference forfield
andsettings
variables)posttypes
orposttype
(seeget_post_types
on WordPress reference forfield
andsettings
variables)tags
ortag
(seeget_the_tags
on WordPress reference forfield
andsettings
variables)taxonomies
ortaxonomy
(seeget_taxonomies
on WordPress reference forfield
andsettings
variables)terms
orterm
(seeget_terms
on WordPress reference forfield
andsettings
variables)users
oruser
(seeget_users
on WordPress reference forfield
andsettings
variables)
Retrieve your value from Database with a simple get_option('my_wordpress_field_id', [])
(see WordPress reference):
// Get wordpress from Database
$wordpress = get_option('my_wordpress_field_id', []);
if (!empty($wordpress)) {
echo '<ul>';
foreach ($wordpress as $post_id) {
echo '<li>'.get_the_title($post_id).'</li>';
}
echo '</ul>';
}
Version | Note |
---|---|
0.0.21 | Add checks on ajax call |
0.0.20 | Add wp-util WordPress integration |
0.0.19 | Fix display and WordPress core functions integration |
- Fork it (https://github.com/GetOlympus/olympus-dionysos-field-wordpress/fork)
- Create your feature branch (
git checkout -b feature/fooBar
) - Commit your changes (
git commit -am 'Add some fooBar'
) - Push to the branch (
git push origin feature/fooBar
) - Create a new Pull Request
Built with ♥ by Achraf Chouk ~ (c) since a long time.