doddo

<p>A plugin which adds a shortcode: <code>[gallery_from_regex_matches]</code> in which a regex attribute should be specified. It will then look for matches in the descriptions and titles of all published images in your library, and create a gallery from the matches it finds.</p>
<ul>
<li>Use for example like this <code>[gallery_from_regex_matches regex="lillill" exclude_ids="764"]</code>, and it will generate a gallery of all your pictures of “Lillill”, except the one which has ID 764.</li>
<li>Sometimes it might be advicable to limit the amount of matches. that can be achieved by adding <code>limit</code> to the shortcode. <code>[gallery_from_regex_matches regex="lillill" exclude_ids="764" limit="10"]</code>.</li>
<li>Sometimes you want to make a gallery of “cats” but not “catsup”, but you don’t want to add <a href="https://dev.mysql.com/doc/refman/5.7/en/regexp.html" rel="nofollow ugc">word boundary</a> <code>[[:>:]]</code>, in this case you can <code>exclude_regex=catsup</code>. Then it could look something along the line of <code>[gallery_from_regex_matches regex="cats" exclude_regex="catsup"]</code>.</li>
<li>The same params (except for <code>ids</code>) as for the <code>[media]</code> shortcode can be used (as this plugin calls that shortcodes callback function (<code>gallery_shortcode()</code>) to generate the gallery), so if you want to specify a particular type (style) of gallery from for example your cat pictures , this might do the trick: <code>[gallery_from_regex_matches regex="(cat|kitten)" type="square"]</code>.</li>
<li>The regular expressions follows the <a href="https://dev.mysql.com/doc/refman/5.7/en/regexp.html" rel="nofollow ugc">MySQL Regexp syntax</a></li>
<li>Some characters will per default not work inside of the shortcode, see the “Caveats” section.</li>
<li>There are no bells and whistles for this plugin but it could potentionally be added in the futre.</li>
</ul>
<h3>Caveats</h3>
<p>Since the regex used by the plugin is specified as an attribute value inside of a shortcode, and the <a href="https://codex.wordpress.org/Shortcode_API" rel="nofollow ugc">Shortcode Api</a> disallows the use of certain characters which could be a part of a valid, useful regex, there are some things to consider.</p>
<blockquote>
<p>Attribute values must never contain the following characters:<br />
   * Square braces: [ ]<br />
   * Quotes: ” ‘</p>
<p>[ … ]<br />
  The recommended method of escaping special characters in shortcode attributes is HTML encoding. Most importantly, any user input appearing in a shortcode attribute must be escaped or stripped of special characters.</p>
</blockquote>
<ul>
<li>if in the regex you need to macth a character set <code>[a-z]</code>, then (following the shortcode Api documentation guidline), they need to be encoded. There are two encodings which the plugin accepts: “html” and “base64” </li>
<li>Currently there is no way to encode these things with help of the plugin, although it is planned for a future release, so the regexes must be encoded manually for now’<br />
For example, for regex <code>w[0u][0u]ti</code> can be expressed either:</li>
</ul>
<p>With HTML encoding:<br />
    <code>[gallery_from_regex_matches regex="w&#091;0u&#093;&#091;0u&#093;ti" encoding="html"]</code></p>
<p>With Base64 encoding:<br />
    <code>[gallery_from_regex_matches regex="d1swdV1bMHVddGk=" encoding="base64"]</code></p>
<p>To encode a string to base64, it can be done from the terminal like this:<br />
    <code>% echo -n "catsup" | base64<br />
Y2F0c3Vw<br />
% echo -n Y2F0c3Vw | base64 --decode<br />
catsup%</code></p>


Gallery From Regex Matches

Maintain a gallery by including all published images in your library which match a regex (in title or description).

Navneil Naicker

<p><strong>Important Notice for New Users of ACF Photo Gallery Field</strong></p>
<p>If you are installing the ACF Photo Gallery Field for the first time on your WordPress website, we’d like to inform you that this plugin will no longer be maintained as of October 2024. As an alternative, we have launched a new and improved plugin called <a href="https://wordpress.org/plugins/acf-galerie-4/" rel="ugc">ACF Galerie 4</a>.</p>
<p>We encourage you to check out <a href="https://wordpress.org/plugins/acf-galerie-4/" rel="ugc">ACF Galerie 4</a> for enhanced features and ongoing support. ACF Galerie 4 includes a built-in migration tool that seamlessly transfers data from ACF Photo Gallery Field or ACF Gallery Pro to ACF Galerie 4. <a href="https://wordpress.org/support/topic/migrate-from-acf-photo-gallery-field-to-acf-galerie-4/" rel="ugc">Learn more</a>.</p>
<p>Thanks</p>
<p>A lightweight extension of Advanced Custom Field (ACF) that adds <strong>Photo Gallery</strong> field to any post/pages on your WordPress website.</p>
<ul>
<li>Visually create your Fields</li>
<li>Add multiple photos and you can also modify title, caption and link to anything</li>
<li>Assign your fields to multiple edit pages (via custom location rules)</li>
<li>Easily load data through a simple and friendly API</li>
<li>Uses the native WordPress custom post type for ease of use and fast processing</li>
<li>Uses the native WordPress metadata for ease of use and fast processing</li>
<li>Supports WordPress classic and Gutenberg editor</li>
<li>RESTFul API</li>
</ul>
<h4>Donation</h4>
<p>Navneil Naicker is the sole developer working on this free WordPress Plugin in his leisure time. He would like to integrate it with premium plugins like Elementor Pro and Advanced Custom Fields Pro. Please donate to support Navneil in continuing further development of this plugin. Click on the link “<a href="https://www.buymeacoffee.com/navzme" rel="nofollow ugc">https://www.buymeacoffee.com/navzme</a>” to donate.</p>
<h4>Usage</h4>
<p><em>acf_photo_gallery</em> is a helper function that takes in <strong>ACF_FIELD_NAME</strong> and <strong>POST_ID</strong> will query the database and compile the images for you. The output of this function will be an array.</p>
<pre><code>acf_photo_gallery(ACF_FIELD_NAME, POST_ID);
</code></pre>
<h4>Example</h4>
<p>The following example is using Twitter Bootstrap framework to layout. You can use any framework of your choice.</p>
<pre><code><?php
    //Get the images ids from the post_metadata
    $images = acf_photo_gallery('vacation_photos', $post->ID);
    //Check if return array has anything in it
    if( count($images) ):
        //Cool, we got some data so now let's loop over it
        foreach($images as $image):
            $id = $image['id']; // The attachment id of the media
            $title = $image['title']; //The title
            $caption= $image['caption']; //The caption
            $full_image_url= $image['full_image_url']; //Full size image url
            $full_image_url = acf_photo_gallery_resize_image($full_image_url, 262, 160); //Resized size to 262px width by 160px height image url
            $thumbnail_image_url= $image['thumbnail_image_url']; //Get the thumbnail size image url 150px by 150px
            $url= $image['url']; //Goto any link when clicked
            $target= $image['target']; //Open normal or new tab
            $alt = get_field('photo_gallery_alt', $id); //Get the alt which is a extra field (See below how to add extra fields)
            $class = get_field('photo_gallery_class', $id); //Get the class which is a extra field (See below how to add extra fields)
?>
<div class="col-xs-6 col-md-3">
    <div class="thumbnail">
        <?php if( !empty($url) ){ ?><a href="<?php echo $url; ?>" <?php echo ($target == 'true' )? 'target="_blank"': ''; ?>><?php } ?>
            <img src="<?php echo $full_image_url; ?>" alt="<?php echo $title; ?>" title="<?php echo $title; ?>">
        <?php if( !empty($url) ){ ?></a><?php } ?>
    </div>
</div>
<?php endforeach; endif; ?>
</code></pre>
<h4>Add Extra Fields</h4>
<p>To add extra fields add the following to your themes functions.php file.</p>
<pre><code>//Create extra fields called Altnative Text and Status
function my_extra_gallery_fields( $args, $attachment_id, $acf_key ){
    $args['alt'] = array(
        'type' => 'text', 
        'label' => 'Altnative Text', 
        'name' => 'alt', 
        'value' => get_field($field . '_alt', $attachment_id)
    );
    $args['status'] = array(
        'type' => 'select', 
        'label' => 'Status', 
        'name' => 'status', 
        'value' => array(
            array(
                '1' => 'Active',
                 '2' => 'Inactive'
            ), 
            get_field($field . '_status', $attachment_id)
        )
    );
    return $args;
}
add_filter( 'acf_photo_gallery_image_fields', 'my_extra_gallery_fields', 10, 3 );
</code></pre>
<p>Supported field types:<br />
* text, date, color, datetime-local, email, number, tel, time, url, week, range, checkbox, radio, textarea, select</p>
<h4>How to get values of extra fields</h4>
<p>You can use ACF helper function <code>get_field</code></p>
<pre><code>get_field('photo_gallery_alt', $id);
get_field('photo_gallery_class', $id);
</code></pre>
<h4>Pull caption from attachment caption field</h4>
<p>By default the caption is being pulled from description field. Add the following filter to your <code>function.php</code> to pull the caption from attachment caption field.</p>
<pre><code>add_filter( 'acf_photo_gallery_caption_from_attachment', '__return_true' );
</code></pre>
<h4>REST API</h4>
<p>Send HTTP Request to URL to get JSON response of all posts</p>
<pre><code>http://{domain}/wp-json/wp/v2/{POST_TYPE}/
</code></pre>
<p>Send HTTP Request to URL to get JSON response of specific post</p>
<pre><code>http://{domain}/wp-json/wp/v2/{POST_TYPE}/{POST_ID}/
</code></pre>
<p>When you receive the response, see the ACF item which contains ACF photo gallery name and array of images.</p>
<h4>Installation and basic usage tutorial</h4>
<p><iframe loading="lazy" title="ACF Photo Gallery Field - Installation and Basic Usage | WordPress" width="750" height="422" src="https://www.youtube.com/embed/c7u9FwVLe9Q?feature=oembed" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen></iframe></p>
<h4>ACF Photo Gallery Field on WordPress Custom Post Type tutorial</h4>
<p><iframe loading="lazy" title="ACF Photo Gallery Field on WordPress Custom Post Type" width="750" height="422" src="https://www.youtube.com/embed/5iTV0JVFFOE?feature=oembed" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen></iframe></p>
<h4>How to use Elementor dynamic tags with ACF Photo Gallery Field plugin tutorial</h4>
<p><iframe loading="lazy" title="How to use Elementor dynamic tags with ACF Photo Gallery Field plugin | WordPress" width="750" height="422" src="https://www.youtube.com/embed/XlSx_weZXoU?feature=oembed" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen></iframe></p>
<h4>Compatibility</h4>
<p>This ACF field type is compatible with: ACF 4, 5 and 6</p>
<h4>Issues</h4>
<p>Just like any other WordPress plugin, this plugin can also cause issues with other themes and plugins. If you are facing issues making this plugin work on your WordPress site, please do ask for help in the support forum. This way we can help you out and prevent this issue from happening to someone else. If you want to talk to me directly, you can contact me via my website <a href="http://www.navz.me/" rel="nofollow ugc">http://www.navz.me/</a></p>


ACF Photo Gallery Field

Hi,

I would like to say that is a nice solution, I use it quite often :)

The great solution :)

PHP Fatal error

A lightweight extension of Advanced Custom Field (ACF) that adds Photo Gallery field to any post/pages on your WordPress website.

Gallery From Regex Matches vs ACF Photo Gallery Field