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.

Jon Christopher

<p><strong>Extensive</strong> usage instructions are <a href="https://github.com/jchristopher/attachments/#attachments" rel="nofollow ugc">available on GitHub</a></p>
<p>Attachments allows you to simply append any number of items from your WordPress Media Library to Posts, Pages, and Custom Post Types.</p>
<h4>Associate Media items with posts</h4>
<p>The idea behind Attachments is to give developers the ability to directly associate Media items with any post. This is accomplished by adding a meta box to post edit screens as determined by the developer. Once Media items have been associated with a post, you’re able to retrieve those Attachments and include them directly within your template files using any specific markup you wish.</p>
<h4>Integrate Attachments within your theme with fine grained control</h4>
<p><strong>Attachments does not automatically integrate itself with your theme.</strong> Since the idea behind Attachments is to allow integration of Media within posts using developer-crafted, unique markup, <em>it’s up to you to integrate with your theme</em>. The most basic integration includes editing the <a href="https://codex.wordpress.org/Template_Hierarchy" rel="nofollow ugc">appropriate template file</a> and adding your call(s) to Attachments. For example, if you have set up Attachments to be used with your Posts entries, edit <code>single.php</code> to include the following within The Loop:</p>
<pre><code><?php $attachments = new Attachments( 'attachments' ); /* pass the instance name */ ?>
<?php if( $attachments->exist() ) : ?>
  <h3>Attachments</h3>
  <p>Total Attachments: <?php echo $attachments->total(); ?></p>
  <ul>
    <?php while( $attachments->get() ) : ?>
      <li>
        ID: <?php echo $attachments->id(); ?><br />
        Type: <?php echo $attachments->type(); ?><br />
        Subtype: <?php echo $attachments->subtype(); ?><br />
        URL: <?php echo $attachments->url(); ?><br />
        Image: <?php echo $attachments->image( 'thumbnail' ); ?><br />
        Source: <?php echo $attachments->src( 'full' ); ?><br />
        Size: <?php echo $attachments->filesize(); ?><br />
        Title Field: <?php echo $attachments->field( 'title' ); ?><br />
        Caption Field: <?php echo $attachments->field( 'caption' ); ?>
      </li>
    <?php endwhile; ?>
  </ul>
<?php endif; ?>
</code></pre>
<p>That snippet will request all of the existing Attachments defined for the current Post within The Loop, and retrieve each itemized property for that Attachment. Using the provided details you’re able to integrate the attached Media items in any way you please.</p>
<p>There is a lot more information on <a href="https://github.com/jchristopher/attachments" rel="nofollow ugc">Attachments’ GitHub page</a>. Please contribute!</p>
<h3>Roadmap</h3>
<p>Please see <a href="https://github.com/jchristopher/attachments/blob/master/docs/roadmap.md" rel="nofollow ugc">Attachments on GitHub</a></p>
<h3>Usage</h3>
<p><strong>Extensive</strong> usage instructions are <a href="https://github.com/jchristopher/attachments/blob/master/docs/usage.md" rel="nofollow ugc">available on GitHub</a></p>


Attachments

This plugin provides functionality that should come with WP core.



The missing plugin

Great plugin

Excellent Plugin

Attachments allows you to simply append any number of items from your WordPress Media Library to Posts, Pages, and Custom Post Types

Simple Stupid Shortcode vs Attachments