Get Post vs Stealth Update

Get Post adds a tag that allows you to retrieve and display the latest post identified by a specific set of parameters. When this plugin is active, any post or page can contain the get-post markup as follows: [get-post tag=some-tag] This will be replaced with the latest post tagged with the given tag. Parameters The parameters control which posts are retrieved by get-post. Options can be used in combination to build a list of criteria for post or posts to retrieve. By mixing criteria, you can exert a lot of control over the post(s) which are found by the plugin. [get-post tag=some-tag random show=3] One note on WordPress in general: if you specify criteria that WordPress can’t match, it will make something up. For instance, if you specify a tag or category that doesn’t exist, it will simply retrieve the latest post with no indication that anything is wrong. Take care to ensure that the options you specify are what you intend. Several of these parameters work best when specifying the slugs. For instance, when specifying a tag it’s best to use the slug value rather than the full name of the tag. To find the slug, see the admin panel -> posts -> post tags. The slug is listed right on that page. You may wish to specify an option value with a space in it. This is accomplished with quotes: [get-post option="a value with spaces"] tag: Specify a tag to search for. The tag’s slug should be specified. [get-post tag=some-tag] category: Specify a category to search for. The category’s slug should be specified. [get-post category=some-category] show: Specify the number of posts to show. [get-post show=5] template: Specify the template to use. This specification overrides the template set in the options panel of the admin interface. See the template section for more details on template tags. NOTE: If entering any HTML into this, please be sure to select the HTML editor rather than the visual editor. [get-post template=" Title: {title} "] random: Select a random post from the matching criteria [get-post random] default: This isn’t really an option. By default, get-post displays the latest blog post. [get-post] Templates Get-post ships with a default template that should render the usual post details in a form that fits well with most themes. You can customize this template to add or remove data from the included post. Additionally, you can use the template parameter to the [get-post] tag to specify a one-off template. Using the show parameter will retrieve multiple posts. In this case, the template will be repeated one time for each retrieved post. These tags are replaced with the value from the retrieved post. For instance, a template containing {title} will actually have the title of the retrieved post, rather than the word title. {title}: The title of the post. {content}: The content of the post. {author}: The author of the post. {date}: The date the post was written. {time}: The time the post was written. {permalink}: A link to the post itself. {authorlink}: A link to all posts by the post’s author. {id}: The post’s ID number. Examples Indicate when your blog was last updated: Blog last updated [get-post template="{date} at {time}."] Link to the latest post: Check out my post: [get-post template=" {title} "] How it works This plugin does something a little bit unorthodox: It reenters “The Loop” while the post content is being rendered. Then, it calls whatever WordPress internal functions will safely work, using raw data from $post when these functions are unsafe to call again. People curious about the internals should examine class-get-post-getter.php. The class is structured to be reusable by any other GPL2 projects.

This plugin allows you to choose to update a post without having WordPress automatically update the post’s post_modified timestamp. WordPress maintains a post field called post_modified which tracks the date the post was last edited. This value is used by feeds to indicate the latest update to each post or to report the latest updated post. Plugins and themes may also reference the post modification date to call attention to posts that have been updated. However, if an update is such that you don’t want it to be recorded in the post_modified date field (perhaps due to the update being a small formatting/editing change or fixing a typo, or if you just want to keep quiet about an update), then this plugin is for you. This plugin adds a “Stealth update?” checkbox to the “Publish” box of any post’s or page’s “Edit Post” admin page. Note: The plugin records when a post is stealth updated, so subsequent edits of the post will have the “Stealth update?” checkbox checked by default. Links: Plugin Homepage | Plugin Directory Page | Author Homepage Filters The plugin is further customizable via two filters. Typically, these customizations would be put into your active theme’s functions.php file, or used by another plugin. c2c_stealth_update_meta_key (filter) The ‘c2c_stealth_update_meta_key’ filter allows you to override the name of the custom field key used by the plugin to store a post’s stealth update status. This isn’t a common need. Arguments: $custom_field_key (string): The custom field key to be used by the plugin. By default this is ‘_stealth-update’. Example: /** * Defines a custom meta key to be used by Stealth Update. * * @param string $custom_field_key The default custom field key name. * @return string */ function override_stealth_update_key( $custom_field_key ) { return '_my_custom_stealth-update'; } add_filter( 'c2c_stealth_update_meta_key', 'override_stealth_update_key' ); c2c_stealth_update_default (filter) The ‘c2c_stealth_update_default’ filter allows you to override the default state of the ‘Stealth Update?’ checkbox. Arguments: $state (boolean): The default state of the checkbox. By default this is false. $post (WP_Post): The post currently being created/edited. Example: // Have the Stealth Update? checkbox checked by default. add_filter( 'c2c_stealth_update_default', '__return_true' );