Shortcode Directives is an open source WordPress plugin that allows you to perform certain actions on posts and comments with shortcode directives.
- Upload
shortcode-directives.phpand other files compressed in the zip folder to the/wp-content/plugins/directory., - Activate the plugin through the
Pluginsmenu in WordPress. - Go to Dashboard -> Tools -> Shortcode Directives.
- Configure the options by checking post types to support the shortcode directives.
- Submit comments with the shortcode directives to perform certain operations against the selected posts/comments from front-end.
Sets a specified post status.
[$post_status {status}]
Changes the post status to pending.
[$post_status pending]
Changes the post status to draft.
[$post_status draft]
Specifies which post to apply the directive operation. This --to option is avialble for all the directives except $comment. Use children, siblings, and descendants for builk actions.
self(default): the comment/post iteself. When a comment with a directive is submitted to a post, that post will be the subject post and it is considered the one denoted by the option value,self.parent: the parent post of the subject post.{post ID}: the post ID.children: the direct child posts of the subjec post if the post type supports thehierarchicaloption.siblings: the sibling posts of the subject post in hierarchical relationships if the post type supports thehierarchicaloption.decendants: all the decendants which belong to the subject post if the post type supports thehierarchicaloption.
This moves all the descendant posts to trash.
[$post_status trash --to=descendants]
Sets a post parent ID.
[$post_parent {post ID}]
Sets a post parent of a post ID of 1451.
[$post_parent 1451]
This removes a post parent.
[$post_parent 0]
The same option values are supported described in the $post_status section above.
Sets a value with a specified post column name to an existent post column.
[$post_column --column={colum name} {value}]
[$post_column --column={colum name} --value="some value"]
Setting the value 3 to the menu_order column.
[$post_column column=menu_order 3]
When a value must have a white space, use the --value option.
[$post_column --column=post_title --value="This is a title"]
The same option values are supported described in the $post_status section above.
Sets a post meta value.
[$post_meta {key} {value}]
[$post_meta {key1}="{some value1}" {key2}="{some value2}" {key3}="{some value3}"...]
This sets the post meta value bar to the _foo meta key.
[$post_meta _foo bar]
For values containing white-spaces and multiple key-value pairs, use the attribute style format.
[$post_meta _question="Why did the chicken cross the road?" _answer="To get to the other side"]
To delete meta keys, use the --action option by passing delete. This deletes the _question and _answer meta keys and their values from the database.
[$post_meta _question _answer --action="delete"]
Note: the --to and --action option names are reserved by the plugin so you cannot specify them with the option name like [$post_meta --action="my value" --to="another value"].
If you have to set them, use the command-line style format introduced above.
[$post_meta --action "Some value here."]
[$post_meta --to "Another value here."]
The same option values are supported described in the $post_status section above.
Sets taxonomy terms with a specified taxonomy slug.
[$taxonomy --slug={taxonomy slug} {term1} {term2} {term3}...]
This adds the Apple, Banana, Apple Pie terms of the post_tag taxonomy to the post.
[$taxonomy --slug=post_tag Apple Banana "Apple Pie"]
add(default) : adds the specified termsremove: removes the specified termsremove_all/remove_all: removes all the associated termsdelete: deletes the specified terms from the database if they are assigned to the postdelete_all/delete-all: deletes all the associated terms from the database
This removes the Apple, Banana, Apple Pie terms of the post_tag taxonomy from the post.
[$taxonomy --slug=post_tag Apple Banana "Apple Pie" --action=remove]
This deletes the Apple, Banana, Apple Pie terms of the post_tag taxonomy from the database if they are assigned to the post.
[$taxonomy --slug=post_tag Apple Banana "Apple Pie" --action=delete]
This removes all the assigned terms of the post_tag taxonomy from the post.
[$taxonomy --slug=post_tag --action=remove_all]
This deletes all the assigned terms of the post_tag taxonomy from the database.
[$taxonomy --slug=post_tag --action=delete_all]
The same option values are supported described in the $post_status section above.
Sets non-hierarchical taxonomy terms.
[$tag {tag1} {tag2} {tag3}...]
When the $tag directive is given, the plugin searches for a non-hierarchical taxonomy associated with the post type of the post and sets the given terms to the post. If a non-hierarchical taxonomy is not found, no action will be taken. If you have multiple non-hierarchical taxonomies for a particular post type which supports shortcode directives, use the $taxonomy directive. See the $taxonomy section above.
This adds the Apple, Banana, Apple Pie tags to the post.
[$tag Apple Banana "Apple Pie"]
The same action values with the $taxonomy directive are supported.
This removes the Apple, Banana, Apple Pie tags from the post.
[$tag --action=remove Apple Banana "Apple Pie"]
This deletes the Apple, Banana, Apple Pie terms from the database if they are assigned to the post.
[$tag --action=delete Apple Banana "Apple Pie"]
This removes all the tags associated with the post.
[$tag --action=remove_all]
This deletes all the tags associated with the post from the database.
[$tag --action=delete_all]
The same option values are supported described in the $post_status section above.
Sets hierarchical taxonomy terms.
[$category {category1} {category2} {category3}...]
When the $category directive is given, the plugin searches for a hierarchical taxonomy associated with the post type of the post and sets the given terms to the post. If a hierarchical taxonomy is not found, no action will be taken. If you have multiple hierarchical taxonomies for a particular post type which supports shortcode directives, use the $taxonomy directive. See the $taxonomy section above.
This adds the Apple, Banana, Apple Pie categories to the post.
[$category Apple Banana "Apple Pie"]
This removes the Apple, Banana, Apple Pie categories from the post.
[$category Apple Banana "Apple Pie" --action=remove]
This deletes the Apple, Banana, Apple Pie categories from the database if they are assigned to the post.
[$category --action=delete Apple Banana "Apple Pie"]
This removes all the categories associated with the post.
[$category --action=remove_all]
This deletes all the categories associated with the post from the database.
[$category --action=delete_all]
The same action values with the $taxonomy directive are supported.
The same option values are supported described in the $post_status section above.
Performs certain actions againt a replying comment. If commented on a post, the action applied to all the comments which belong to the post. So be careful not to do that when you want to do someting on a single comment.
[$comment {sub-command}]
delete/remove: deletes the commenthold/disapprove: changes the comment status tohold.trash: moves the comment to trashspam: mark the commet as spamconvert: converts the comment to a child post.
Replying to an existent comment with the following deletes the comment.
[$comment delete]
For hierarchical post types, the convert sub-command can help bulk-convert comments in to posts.
Commenting on a post (not an existent comment) converts all the comments belonging to the post into posts by keeping the hirarchical relationships.
[$comment convert]
If you find an issue, let us know here!
This is a developer's portal for Shortcode Directives and should not be used for support. Please visit the support forums.
Anyone is welcome to contribute to Shortcode Directives.
There are various ways you can contribute:
- Raise an Issue on GitHub.
- Send us a Pull Request with your bug fixes and/or new features.
- Provide feedback and suggestions on enhancements.
If you like it, please rate and review it in the WordPress Plugin Directory. Also donation would be greatly appreciated. Thank you!
Released under the GPL v2 or later. Copyright © 2015 Michael Uno
This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.