Home Plugins simple stupid shortcode
Simple Stupid Shortcode logo

Simple Stupid Shortcode

by lorenzck on WordPress.org

The simplest and most flexible way to embed images or put internal links in Wordpress. Shortcodes to finally ditch all absolute paths and fixed sizes.

(0)
Shortcode generation button with file picker.

Shortcode generation button with file picker.

The usual way to include images in WordPress posts is to generate static anchor and tags through the content editor interface. Similarly, links to other posts or pages of your blog are also generated as absolute tags by the content editor.
These kind of fixed links make your WordPress site hard to migrate and make it especially hard to automatically change your output markup (for instance if you decide to change the image size or change a post’s title).

No longer.
With this plug-in, you can use the simple [image], [link], and [page] shortcodes in any of your posts.

Image shortcode

Images are referenced by their ID, for instance:

[image id="123"]

This shortcode will generate the following HTML structure:

Images default to their medium size, if none is set.
You may easily add HTML classes or didascalies:

[image id="123" didascaly="Nice picture." class="aligncenter"]

This generates the following HTML block, which can be easily styled with some custom CSS:

Nice picture.

The [image] shortcode supports the following parameters:

  • id: the WordPress ID of the attachment to include;
  • size: size of the image to include (can be any standard size such as thumbnail, medium, full, or any custom image size);
  • alt: alternate description to include in the tag;
  • title: image title to use in (optional) link;
  • link: if set to true, 1, yes, or an equivalent value, a link to the full-resolution attachment will be generated, otherwise a fully specified target URL can be specified;
  • didascaly: text to add as a didascaly;
  • class: additional HTML/CSS classes to add to the root element.
  • atts: additional HTML attributes to add to the wrapping
    tag.
  • imgatts: additional HTML attributes to add to the internal tag of the image.

Page and link shortcodes

This couple of shortcodes automatically generate hypertext links to pages or posts of your WordPress installation. Target posts can be referenced by ID, by slug, or by path (a post’s URL, relative to the website’s root).

Thus, [link href="123"]…[/link], [link href="slug-of-post"]…[/link], and [link href="root-page/sub-page/slug-of-page"]…[/link] are all equivalent.

These shortcodes are “enclosing” (they wrap the content of the link, just like HTML tags) and they support the following parameters:

  • href: the ID, slug, or path of the target post or page;
  • title: the title to use in the link, if not set the target post’s title will be used;
  • class: additional HTML/CSS classes to add to the link;
  • type: type of the target post (defaults to “page” for [page] and “post” for [link]).

If no link content to be enclosed is provided, the posts’s title is automatically used as link text.

Simple Stupid Shortcode | Plugin0