Postie Shortcodes AddOn

Control your Postie posts with shortcodes!

With this AddOn not only can you control your title, post format, post type, comment control, post status, tags, categories, post date and excerpt using simple shortcodes, but there are new features as well.

New features not available in Postie

This AddOn also give you the ability to:

  • Insert an image from the media library
  • Set an image from the media library as the featured image
  • Insert custom fields
  • Mark a post as featured/sticky
  • Control pingbacks
  • Insert a “read more” marker
  • Insert a “next page” marker for multi-page posts
  • Set the author
  • Attach terms in custom taxonomies
  • Set the post slug

Add your own custom shortcodes

You can add you own Postie shortcodes as described here.

Examples

[pimage id=101]

This will insert the image with id 101 into the post. The image is assigned the CSS class postie-shortcode-image if you want to style it. Typically you’d use this when you want to use an image already in your media list. Since the id is unknown ahead of time you can’t use this to specify an image in the email.

[pslug slug="my awesome slug"]

This will set the post slug to “my-awesome-slug”. Note that WordPress will “sanitize” anything you put in the slug value so that it is valid in a URL and that it is unique.

[pfeatured id=101]

This will assign the image with id 101 as the featured image for the post. Typically you’d use this when you want to use an image already in your media list. Since the id is unknown ahead of time you can’t use this to specify which image in the email should be the featured image.

[psticky]

This will make the post a featured/sticky post.

[pmore]

This will insert a “read more” marker into the post.

[pnextpage]

This will insert a page break into the post so that you can have multi-page posts.

[ptitle title="My cool title"]

This change the title of the post to “My cool title” regardless of the subject line of the email.

[pformat format=quote]

This will change the post format to a quotation. Any post format your site supports can be selected.

[ptype type=page]

This will change the post type to a page. Any post type your site supports can be selected.

[pcomments comments=closed]

This will close the post for comments.

[ppings pings=closed]

This will close the post for pingbacks.

[pstatus status=draft]

This will set the post status as draft. publish, pending, private and future are also supported. If you have a custom status that is also supported.

[ptag tag=tag1]
[ptags tags="tag1, tag2"]

This allows you to set the tags on a post. Provide 1 tag or as many as you want separated by commas. You can also use this shortcode multiple times. Using this shortcode will override any default tags.

[pcategories categories="cat1, cat"]
[pcategory category=cat3]

This allows you to set the categories for a post. Provide 1 category or as many as you want separated by commas. The categories must exist ahead of time. This also supports custom taxonomies. You can also use this shortcode multiple times. Using this shortcode will override any default category.

[pdate date="Jun 15, 2014"]

This allows you to specify the date for a post. Use this in combination with [pstatus future] to create scheduled posts.

[pexcerpt]The is my neato excerpt[/pexcerpt]

This will add an excerpt to your post.

[pcustom name=fieldname value="my value"]
[pcustom name="array{index}" value="array element value"]

This will add a custom field to the post set to the value. You can also use this shortcode multiple times. Note you can also reference an array in the name parameter. Due to WordPress limitations the array notation cannot use square brackets (i.e. don’t do [pcustom name=”array[index]” value=1]) rather use curly braces instead. There is currently no way to delete an array index, nor are multidimensional arrays supported (e.g. [pcustom name=”array[index1][index2]” value=1] will not work).

[pterm taxonomy=taxonomyslug term=termslug]
[pterm taxonomy=taxonomyslug term="term1, term2"]

This will add term to the post from the custom taxonomy. Typically you would use this with custom post types that have their own taxonomy. You can use this shortcode multiple times. You can provide multiple terms if you separate them with commas. Note you may need to set the “Force User Login” setting to “Yes” to use custom taxonomies.

[pauthor author=1]
[pauthor author="wayne@postieplugin.com"]
[pauthor author=wayne]

This will change the author to the indicated WordPress user. You can specify by id, slug, email or login.

Release Notes

1.2.6 released 2017-04-12

  • pterm now allows multiple terms to be specified.

1.2.5 released 2017-04-05

  • Fix issue with pdate
  • Add autoupdater

1.2.4 released 2017-02-12

  • Fixed an issue with the new array support with pcustom

1.2.3 released 2017-02-07

  • Add support for array references in pcustom

1.2.2 released 2016-12-06

  • Added pslug

1.2.1 released 2016-07-28

  • Added pimage
  • Added pfeatured
  • Now using official shortcode format. [shortcode param=value]

1.1.7 released 2016-06-01

  • Fixed a bug with pmore

1.1.6 released 2015-12-04

  • Added pauthor

1.1.5 released 2015-11-19

  • Added pnextpage

1.1.4 released 2015-09-18

  • Additional logging for taxonomies

1.1.3 released 2015-09-14

  • Fix multiple categories in a single shortcode
  • Fix initial category/tag detection when there are multiple messages

1.1.2 released 2015-09-10

  • Fix html entity encoding of quoted parameters

1.1.1 released 2015-06-26

  • The first category or tag shortcode removes the default

1.1.0 released 2015-05-20

  • Added pterm

1.0.3 released 2015-05-11

  • Fix where other shortcodes were running

1.0.2 released 2015-05-11

  • Fix bug where multiple categories not getting set

1.0.2 released 2015-04-29

  • Initial release