mark l chaves

<p>With <strong>GIC</strong>, you can display the title, caption, and description image attributes. You can also change/filter the rendering HTML to whatever you want.</p>
<p>After installing and activating GIC, write your filter and add the WordPress <a href="https://codex.wordpress.org/Gallery_Shortcode" rel="nofollow ugc">Gallery shortcode</a> to your page.</p>
<p>If you’ve been <em>dreaming</em> of writing a filter to customise the gallery image captions, then this plugin is for you.</p>
<p><a href="https://streetphotography.blog/gallery-image-captions-demo/" rel="nofollow ugc">Visit the live demo page.</a></p>
<h4>Motivation</h4>
<p>The default WordPress gallery shortcode will only display the <strong>caption</strong> from the media’s attachment metadata. Sometimes it’s nice to display more like the title—even the description.</p>
<p>The <strong>GIC plugin</strong> overrides the WordPress gallery shortcode function to create a <a href="https://developer.wordpress.org/plugins/hooks/" rel="nofollow ugc">hook</a>. With this <em>hook</em> you can do a little bit more than just displaying the caption.</p>
<p>Some premium themes hide the caption completely. This leaves photography lovers like me scratching their head and spending precious time cobbling together makeshift caption blocks.</p>
<h3>Usage</h3>
<h4>Custom Filter For Displaying Captions</h4>
<p>The <strong>crux</strong> of this plugin is the ability to filter the gallery image caption. The <code>galimgcaps_gallery_image_caption</code> hook makes this possible.</p>
<p>For the usage examples below, this is the filter used.</p>
<pre><code>/**
 * Custom Filter for Gallery Image Captions
 *
 * Note: Avoid altering captiontag, selector, and itemtag.
 */
function mlc_gallery_image_caption($attachment_id, $captiontag, $selector, $itemtag) {

    $id = $attachment_id;

    // Grab the meta from the GIC plugin.
    $my_image_meta = galimgcaps_get_image_meta($id);

    /**
     * Here's where to customise the caption content.
     * 
     * This example uses the meta title, caption, and description. 
     * 
     * You can display any value from the $my_image_meta array. 
     * You can add your own HTML too.
     */
    return "<{$captiontag} class='wp-caption-text gallery-caption' id='{$selector}-{$id}'>" .
            "Title: " . $my_image_meta['title'] . "<br>" .
            "Caption: " . $my_image_meta['caption'] . "<br>". 
            "Description: ". $my_image_meta['description'] . 
        "</{$captiontag}></{$itemtag}>";

}
add_filter('galimgcaps_gallery_image_caption', 'mlc_gallery_image_caption', 10, 4);
</code></pre>
<p>Feel free to use this filter code as a starter template. After activating the GIC plugin, add the code above to your child theme’s <code>functions.php</code> file. Rename the function and tweak the return string to suit your needs.</p>
<h4>New Filter To Get Custom Fields</h4>
<pre><code>/**
 * New GIC 1.4.0 filter for custom meta fields.
 */
function gic_add_custom_fields( $image_meta, $attachment ) {

    // This is how you add a custom fields to the array that
    // GIC uses to display captions.
    $image_meta['credit_text'] = $attachment->credit_text;
    $image_meta['credit_link'] = $attachment->credit_link;

    return $image_meta;
}
add_filter( 'galimgcaps_image_meta', 'gic_add_custom_fields', 10, 2 );
</code></pre>
<p>To use these two custom fields, your <code>galimgcaps_gallery_image_caption</code> would look something like this.</p>
<pre><code>function mlc_gallery_image_caption($attachment_id, $captiontag, $selector, $itemtag) {

    $id = $attachment_id;

    // Grab the meta from the GIC plugin.
    $my_image_meta = galimgcaps_get_image_meta($id);

    // If there's credit, give it where it's due complete with link.
    $credit = $my_image_meta['description'] ? 
        "<br><strong>Credit</strong>: <a style='display: inline;' href='" . 
        $my_image_meta['credit_link'] . 
        "'>" . $my_image_meta['credit_text'] . "</a>" . "<br>" : 
        '';

    /**
     * With GIC 1.4.0 you can also add custom media attachment fields
     * to your captions.
     */
    return "<{$captiontag} class='wp-caption-text gallery-caption' id='{$selector}-{$id}'>" .
            "<strong>Caption</strong>: " . $my_image_meta['caption'] . "<br>" . 
            $credit .
            "</{$captiontag}></{$itemtag}>";

}
add_filter('galimgcaps_gallery_image_caption', 'mlc_gallery_image_caption', 10, 4);
</code></pre>
<p><strong>Since v1.2.0</strong>, GIC automatically adds an <strong>Image ID</strong> column to your WordPress Media Library. This is to help you add the image IDs to your GIC shortcodes.</p>
<p><a href="https://ps.w.org/gallery-image-captions/assets/screenshot-11.png" rel="nofollow ugc">See where GIC automatically adds an Image ID column to your WordPress Media Library.</a></p>
<p><strong>New in v1.4.0</strong>, GIC support custom media attachment fields.</p>
<h3>Usage Example 1</h3>
<h4>Shortcode</h4>
<p>For starters, let’s use a</p>
<pre><code><p></p> 
</code></pre>
<p>tag for the caption tag.</p>
<pre><code>[gallery size="full" columns="1" link="file" ids="114" captiontag="p"]
</code></pre>
<h4>Styling</h4>
<p>Let’s override the generated styles with our own style for one particular image.</p>
<pre><code>/* Targeting a Specific Image */

/* Add some padding all around. */
#gallery-1 .gallery-item, 
#gallery-1 .gallery-item p {
    padding: 1%;
}

/* Add some moody background with typewriter font. */
#gallery-1 .gallery-item {
    color: whitesmoke;
    background-color: black;
    font-size: 1.25rem;
    font-family: Courier, monospace;
    text-align: left !important;
}
</code></pre>
<h3>Usage Example 2</h3>
<h4>Shortcode</h4>
<p><strong>A 2 column x 1 row gallery with large size images using an H4 for the caption.</strong></p>
<pre><code>[gallery size="large" columns="2" link="file" ids="109,106" captiontag="h4"]
</code></pre>
<p><strong>A 3 column x 1 row gallery with medium size images using a blockquote for the caption.</strong></p>
<pre><code>[gallery size="medium" columns="3" link="file" ids="109,106,108" captiontag="blockquote"]
</code></pre>
<p>Did you notice that we are using</p>
<pre><code><blockquote></blockquote> 
</code></pre>
<p>in the second shortcode? Let’s give it try just for <em>kicks</em>.</p>
<h4>Styling</h4>
<pre><code>/* 1. Style the H4 Used in the Caption Example */
h4 {
    color: #777777 !important;
    font-size: 1.2rem !important;
    font-family: Helvetica, Arial, sans-serif !important;
}

/* 2. Help Align the Blockquote */
#gallery-3 .gallery-caption {
    margin-left: 40px !important;
}
</code></pre>
<h3>Responsive CSS Example</h3>
<p>I recommend adding the following media queries if you use galleries with more than one image. The two media queries below will stack 2×1 and 3×1 galleries into a 1 column x n rows or 2 column x n rows  as needed.</p>
<pre><code>/* Media Queries for Responsive Galleries */

/**
 * Styling based on article "How To: Style Your WordPress Gallery"
 * by Par Nicolas.
 * 
 * https://theme.fm/how-to-style-your-wordpress-gallery/
 */

/* Mobile Portrait Breakpoint - 1 column */
@media only screen and (max-width: 719.998px) {
    .gallery-columns-2 .gallery-item,
    .gallery-columns-3 .gallery-item { 
     width: 100% !important; 
  }
}

/* Mobile Landscape and Tablet Breakpoints - 2 columns */
@media only screen and (min-width: 720px) and (max-width: 1024px) {
  .gallery-columns-3 .gallery-item { 
     width: 50% !important; 
  }
}
</code></pre>


Gallery Image Captions (GIC)

Gallery Image Captions (GIC) allows you to customise WordPress gallery image captions.

David Artiss

<p>Code Embed allows you to embed code (JavaScript, CSS and HTML – it can’t be used for server-side code, such as PHP) in a post, without the content being changed by the editor. This is incredibly useful for embedding third-party scripts, etc. The plugin is used by many large sites, including Mozilla.</p>
<p>Key features include…</p>
<ul>
<li>Add HTML or JavaScript to posts or pages – particularly useful for embedding videos!</li>
<li>Embed in widgets using the <a href="https://wordpress.org/extend/plugins/widget-logic/" title="Widget Logic" rel="ugc">Widget Logic</a> plugin</li>
<li>Global embedding allows you set up some code in one post or page and then access it from another</li>
<li>Modify the keywords or identifiers used for embedding the code to your own choice</li>
<li>Search for embedding code via a simple search option</li>
<li>Add a simple suffix to the embed code to convert videos to responsive output</li>
<li>Embed an external script directly using just the URL</li>
<li>And much, much more!</li>
</ul>
<p>Iconography is courtesy of the very talented <a href="https://www.fiverr.com/jankirathore" rel="nofollow ugc">Janki Rathod</a>.</p>
<p><strong>Please visit the <a href="https://github.com/dartiss/code-embed" title="Github" rel="nofollow ugc">Github page</a> for the latest code development, planned enhancements and known issues</strong></p>
<h3>Getting Started</h3>
<p>To use this plugin, you need to have custom fields enabled on your site. If you’re using the block editor, you may need to switch this on first – please scroll down to the next section to learn how to do this. If you’re using the classic editor then you’ll find the custom fields at the bottom of the editor screen.</p>
<p>Although this plugin works for both posts and pages for simplicity I will simply refer to posts – bear in mind that pages work in the same way.</p>
<p>Once you have custom fields switched on, here’s how easy it is to use…</p>
<ol>
<li>Once you have the plugin installed start a new post.</li>
<li>Scroll down to the bottom of the screen and look for the “Custom Fields” section.</li>
<li>Under “Add New Custom Field” enter a name of <code>CODE1</code> and your embed code as the value</li>
<li>In your post content add <code>{{CODE1}}</code> where you wish the embed code to appear.</li>
</ol>
<p>And that’s it – when the post viewed or previewed <code>{{CODE1}}</code> will be replaced with the code that you asked to be embedded.</p>
<p>This should get you started – for more information and advanced options please see below.. Alternatively, there’s a fantastic guide at <a href="http://www.elftronix.com/free-easy-plugin-add-javascript-to-wordpress-posts-pages/" title="Free Easy Plugin! Add Javascript to WordPress Posts & Pages" rel="nofollow ugc">Elftronix</a> which I would recommend.</p>
<h3>Using this plugin with the block editor (aka Gutenberg)</h3>
<p>By default, custom fields are hidden inside the block editor but can be revealed.</p>
<ol>
<li>Edit or create a post</li>
<li>Click the settings button (three dots) in the top, right-hand corner</li>
<li>Go to Preferences</li>
<li>Click the Panels tab</li>
<li>You will find a button to toggle the ‘Custom Fields’ meta box – make sure this is toggled to “on”</li>
<li>A button should appear titled “Enable & Reload” – you’ll need to click on that and wait for the page to reload before the custom fields will appear</li>
</ol>
<p>Check out the screenshots for how the custom fields should look.</p>
<h3>I can’t find the custom fields</h3>
<p>For block editor users, I’m assuming you’ve done the above. For classic editor users, the custom fields should be present by default. In all cases they should appear at the bottom of the editor screen.</p>
<p>From version 2.4, anyone without the “unfiltered HTML” capability won’t be able to see custom fields, for added security. Please see the section “Custom Field Security”, below, for more details.</p>
<p>If none of the above applies then you may have a theme or plugin that removes this or may have a problem with your WordPress installation – you will need to try the usual diagnostics to try and resolve this, including requesting help on <a href="https://wordpress.org/support/forum/how-to-and-troubleshooting/" title="Fixing WordPress Forum" rel="ugc">the WordPress support forum</a>.</p>
<p>Please bear in mind that the custom fields functionality is part of WordPress so it would be greatly appreciated if you don’t give me poor reviews in this situation as, I say, this component is not part of this plugin but, by using it, keeps this plugin simple to use and bloat-free 🙂</p>
<h3>The Code Embed Options Screen</h3>
<p>Whilst in WP Admin, if you go to Settings -> Code Embed, you’ll be able to access the options that are available for this plugin.</p>
<p>Code embedding is performed via a special keyword that you must use to uniquely identify where you wish the code to appear. This consist of an opening identifier (some that that goes at the beginning), a keyword and then a closing identifier. You may also add a suffix to the end of the keyword if you wish to embed multiple pieces of code within the same post.</p>
<p>From this options screen you can specify the above identifier that you wish to use. By default the opening and closing identifiers are percentage signs and the keyword is <code>CODE</code>. During these instructions these will be used in all examples.</p>
<p>The options screen is only available to those that with a capability of able to manage options or greater. All the other Code Embed menu options are available to users with a capability to edit posts or greater.</p>
<h3>How to Embed Code</h3>
<p>To embed in a post you need to find the meta box under the post named “Custom Fields”. If this is missing you may need to add it by clicking on the “Screen Options” tab at the top of the new post screen.</p>
<p>Now create a new custom field with the name of your keyword – e.g. <code>CODE</code>. The value of this field will be the code that you wish to embed. Save this custom field.</p>
<p>Now, wherever you wish the code to appear in your post, simply put the full identifier (opening, keyword and closing characters). For example, <code>{{CODE}}</code>.</p>
<p>If you wish to embed multiple pieces of code within a post you can add a suffix to the keyword. So we may set up 2 custom fields named <code>CODE1</code> and <code>CODE2</code>. Then in our post we would specify either <code>{{CODE1}}</code> or <code>{{CODE2}}</code> depending on which you wish to display.</p>
<p>Don’t forget – via the options screen you can change any part of this identifier to your own taste.</p>
<h3>How to Embed Code from an External URL</h3>
<p>If you specify a URL within your post, surrounded by your choice of identifiers, then the contents of the URL will be embedded within your post.</p>
<p>Obviously, be careful when embedding a URL that you have no control over, as this may be used to hijack your post by injecting, for example, dangerous JavaScript.</p>
<p>For example, using the default options you could embed the contents of a URL using the following method…</p>
<pre><code>{{http://www.example.com/code.php}}
</code></pre>
<p>or</p>
<pre><code>{{https://www.example.com/code.html}}<h3>How to Use Global Embedding</h3>
</code></pre>
<p>You can also create global embeds – that is creating one piece of embed code and using it in multiple posts or pages.</p>
<p>To do this simply make reference to an already defined (but unique) piece of embed code from another post or page.</p>
<p>So, let’s say in one post you define a custom field named <code>CODE1</code>. You can, if you wish, place <code>{{CODE1}}</code> not just in that post but also in another and it will work.</p>
<p>However, bear in mind that the embed code name must be unique – you can’t have defined it in multiple posts otherwise the plugin won’t know which one you’re referring to (although it will report this and list the posts that it has been used in).</p>
<p>In the administration menu there is a sidebar menu named “Tools”. Under this is a sub-menu named “Code Search”. Use this to search for specific embed names and it will list all the posts/pages that they’re used on, along with the code for each.</p>
<h3>Embedding in Widgets</h3>
<p>Natively you cannot use the embed facilities within sidebar widgets. However, if you install the plugin <a href="https://wordpress.org/extend/plugins/widget-logic/" title="Widget Logic" rel="ugc">Widget Logic</a> then Code Embed has been set up to make use of this and add the ability.</p>
<ul>
<li>Install <a href="https://wordpress.org/extend/plugins/widget-logic/" title="Widget Logic" rel="ugc">Widget Logic</a> and activate.</li>
<li>In Administration, select the Widgets page from the Appearance menu. At the bottom there will be a set of Widget Logic options.</li>
<li>Ensure Use ‘widget_content’ filter is ticked and press Save.</li>
</ul>
<p>Although you cannot set up embed code within a widget you can make reference to it, for example by writing <code>{{CODE1}}</code> in the widget.</p>
<h3>Responsive Output Conversion</h3>
<p>Responsive output is where an element on a web page dynamically resizes depending upon the current available size. Most video embeds, for instance, will be a fixed size. This is fine if your website is also of a fixed size, however if you have a responsive site then this is not suitable.</p>
<p>Code Embed provides a simple suffix that can be added to an embed code and will convert the output to being responsive. This works best with videos.</p>
<p>To use, when adding the embed code onto the page, simply add <code>_RES</code> to the end, before the final identifier. For example, <code>{{CODE1_RES}}</code>. The <code>_RES</code> should not be added to the custom fields definition.</p>
<p>This will now output the embedded code full width, but a width that is dynamic and will resize when required.</p>
<p>If you don’t wish the output to be full width you can specify a maximum width by adding an additional <code>_x</code> on the end, where <code>x</code> is the required width in pixels. For example, <code>{{CODE1_RES_500}}</code> this will output <code>CODE1</code> as responsive but with a maximum width of 500 pixels.</p>
<p><strong>It should be noted that this is an experimental addition and will not work in all circumstances.</strong></p>
<h3>Embedding in excerpts</h3>
<p>By default embed code will not appear in excerpts. However, you can switch this ability on via the Code Embed options screen. If you do this then the standard rules of excerpts will still apply, but now once the code embed has applied – for example, excerpts are just text, a specific length, etc.</p>
<h3>Filtering of code</h3>
<p>By default, WordPress allows unfiltered HTML to be used by users in post custom fields, even if their role it set up otherwise. This opens up the possibility of leaving a site vulnerable, if any plugins that uses this data doesn’t check it appropriately.</p>
<p>“Out of the box”, neither the contributor and author roles have unfiltered HTML capabilities but can access custom post fields.</p>
<p>As this plugin requires the use unfiltered HTML, we need to ensure that the only users who use it, should be using it. From version 2.5, any users without this permission that update a post containing embeds from this plugin will cause the code to be filtered.</p>
<h3>Reviews & Mentions</h3>
<p>“Works like a dream. Fantastic!” – Anita.</p>
<p>“Thank you for this plugin. I tried numerous other iframe plugins and none of them would work for me! This plugin worked like a charm the FIRST time.” – KerryAnn May.</p>
<p><a href="http://wsdblog.westbrook.k12.me.us/blog/2009/12/24/embedding-content/" title="Embedding content" rel="nofollow ugc">Embedding content</a> – WSD Blogging Server.</p>
<p><a href="http://comohago.conectandonos.gov.ar/2009/08/05/animando-imagenes-con-photopeach/" title="Animando imágenes con PhotoPeach" rel="nofollow ugc">Animating images with PhotoPeach</a> – Cómo hago.</p>


Code Embed

Code Embed provides a very easy and efficient way to embed code (JavaScript, CSS and HTML) in your posts and pages.

Gallery Image Captions (GIC) vs Code Embed