lorenzck

<p>The usual way to include images in WordPress posts is to generate static anchor and <code><img></code> tags through the content editor interface. Similarly, links to other posts or pages of your blog are also generated as absolute <code><a></code> tags by the content editor.<br />
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).</p>
<p>No longer.<br />
With this plug-in, you can use the simple <code>[image]</code>, <code>[link]</code>, and <code>[page]</code> shortcodes in any of your posts.</p>
<h4>Image shortcode</h4>
<p>Images are referenced by their ID, for instance:</p>
<pre><code>[image id="123"]
</code></pre>
<p>This <em>shortcode</em> will generate the following HTML structure:</p>
<pre><code><div class="picture wp-image-123 size-medium">
  <img src="path-to-123-medium.jpg" srcset="…" />
</div>
</code></pre>
<p>Images default to their <code>medium</code> size, if none is set.<br />
You may easily add HTML classes or didascalies:</p>
<pre><code>[image id="123" didascaly="Nice picture." class="aligncenter"]
</code></pre>
<p>This generates the following HTML block, which can be easily styled with some custom CSS:</p>
<pre><code><div class="picture wp-image-123 size-medium aligncenter">
  <img src="path-to-123-medium.jpg" srcset="…" />
  <div class="didascaly">Nice picture.</div>
</div>
</code></pre>
<p>The <code>[image]</code> <em>shortcode</em> supports the following parameters:</p>
<ul>
<li><code>id</code>: the WordPress ID of the attachment to include;</li>
<li><code>size</code>: size of the image to include (can be any standard size such as <code>thumbnail</code>, <code>medium</code>, <code>full</code>, or any custom image size);</li>
<li><code>alt</code>: alternate description to include in the <code><img></code> tag;</li>
<li><code>title</code>: image title to use in (optional) link;</li>
<li><code>link</code>: if set to <code>true</code>, <code>1</code>, <code>yes</code>, or an equivalent value, a link to the full-resolution attachment will be generated, otherwise a fully specified target URL can be specified;</li>
<li><code>didascaly</code>: text to add as a didascaly;</li>
<li><code>class</code>: additional HTML/CSS classes to add to the root element.</li>
<li><code>atts</code>: additional HTML attributes to add to the wrapping <code><div></code> tag.</li>
<li><code>imgatts</code>: additional HTML attributes to add to the internal <code><img></code> tag of the image.</li>
</ul>
<h4>Page and link shortcodes</h4>
<p>This couple of <em>shortcodes</em> automatically generate hypertext links to pages or posts of your WordPress installation. Target posts can be referenced by ID, by <em>slug</em>, or by <em>path</em> (a post’s URL, relative to the website’s root).</p>
<p>Thus, <code>[link href="123"]…[/link]</code>, <code>[link href="slug-of-post"]…[/link]</code>, and <code>[link href="root-page/sub-page/slug-of-page"]…[/link]</code> are all equivalent.</p>
<p>These <em>shortcodes</em> are “enclosing” (they wrap the content of the link, just like HTML tags) and they support the following parameters:</p>
<ul>
<li><code>href</code>: the ID, <em>slug</em>, or <em>path</em> of the target post or page;</li>
<li><code>title</code>: the title to use in the link, if not set the target post’s title will be used;</li>
<li><code>class</code>: additional HTML/CSS classes to add to the link;</li>
<li><code>type</code>: type of the target post (defaults to “page” for <code>[page]</code> and “post” for <code>[link]</code>).</li>
</ul>
<p>If no link content to be enclosed is provided, the posts’s title is automatically used as link text.</p>


Simple Stupid Shortcode

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.

Scott Werner

<p>By default, WordPress links images to themselves. A user sees that the image is a link, clicks it and they are then taken to a page of just the image. Then they click ‘back’ in their browser or move on to another site.</p>
<p>You could manually remove the link, but that is a pain. Plus, when handing sites over to clients they shouldn’t have to remember to remove it to have a great functioning site.</p>


No Image Link

Defaults the Image Link option to 'none' when adding a picture to a page or post.

Simple Stupid Shortcode vs No Image Link