wundermatics

nick6352683

<p>Adds a formula fields ot Advanced Custom Fields that allows you to perform simple math based on field values. Calculations are updated dynamically via ajax while editing a post on the backend post editor as well as on front end forms.</p>
<h3>Requirements</h3>
<p>Calculated fields requires Advanced Custom Fields 5.0 or later and works with Pro as well as the standard version.</p>
<h3>Frontend forms</h3>
<p>Beginning in version 1.2.3, Calculated fields for ACF supports frontend forms created using the acf_form() function (built in to Advanced Custom Fields).</p>
<h4>Formulas</h4>
<p>Calculated fields adds a new setting “Formula” to the the ACF field editor. Formulas supports referring to other fields in the same Field group using the field name. If a formula is added to a sub field inside a repeater field, the name refers to another sub field in the same repeater.</p>
<p>A sub field inside a repeater field can also refer to a parent field using the “parent.”” prefix.</p>
<p>A formula can contain the basic mathematical operations: plus (+), minus (-), multiply (*), division (/) and power of (^). Formulas can also contains functions like sin, cos, arcsin, log, ln, sqrt, abs. Parentheses are supported.</p>
<p>If an expression can’t be evaluated due to invalid syntax or referring to undefined field names, it will silently return zero.</p>
<p>Examples of valid expressions (note, no equal sign at the beginning):</p>
<ul>
<li>fieldA * 2</li>
<li>fieldA * fieldB</li>
<li>abs(fieldA) * (2 + sqrt(fieldB))</li>
<li>amount * parent.price</li>
</ul>
<h4>Conditional operators</h4>
<p>An expression can also contain a conditional expression that will return either 0 or 1. The supported operators are:</p>
<ul>
<li>Equals (==) – Returns 1 when two values are equal, 0 otherwise</li>
<li>Not equals (!=) – Returns 1 when two values are not equal, 0 otherwise</li>
<li>Greater than (>) – Returns 1 when the first operand is greater than the second, 0 otherwise</li>
<li>Greater than or equal (>=) – Returns 1 when the first operand is greater than or equal to the second, 0 otherwise</li>
<li>Less than (<) – Returns 1 when the first operand is less than the second, 0 otherwise</li>
<li>Less than or equal (<=) – Returns 1 when the first operand is less than or equal to the second, 0 otherwise</li>
</ul>
<p>Examples of valid expressions using conditional operators:</p>
<ul>
<li>10 == 10 (returns 1)</li>
<li>10 == 2 (returns 0)</li>
<li>10 > 2 (returns 1)</li>
<li>10 < 2 (returns 0)</li>
<li>10 <= 10 (returns 1)</li>
</ul>
<h4>Rounding functions</h4>
<p>Round a decimal value to the nearest integer. Supported functions are:</p>
<ul>
<li>round() – Uses standard mathematical rounding rules to round to nearest integer</li>
<li>ceil() – Rounds the value to the next higher integer</li>
<li>floor() – Rounds the value to the next lower integer</li>
</ul>
<p>Examples of valid expressions using rounding functions:</p>
<ul>
<li>round(10.2) (returns 10)</li>
<li>round(10.9)  (returns 11)</li>
<li>round(10.888888 * 10) / 10 (returns 10.9)</li>
<li>ceil(10.2) (returns 11)</li>
<li>floor(10.2) (returns 10)</li>
</ul>
<p>Note that the round() function only takes one parameter and always round to an integer. If you need to round to a higher precision, multiply and divide as shown in third example above.</p>
<h4>Group fields (new from 1.2.4)</h4>
<p>Fields defined as part of a group, subfields, can be addressed using the group name as a prefix. Inside the group, a field defined on the parent level can be addressed using the “parent” prefix. See examples below:</p>
<p>Valid formula to use the value of field “foobar” defined inside the group “group2”:<br />
* group2.foobar + 10</p>
<p>Valid formula in a field inside a group (assuming the parent has a field named count):<br />
* parent.count * 22</p>
<h4>Array functions for repeater fields</h4>
<p>If repeater fields are used, a calculated field in the parent field group can summarize a specific repeater sub fields using the aggregation functions sum, count, average, min or max. For example, the expression: “Sum(orderlines.amount)”” will return the sum of all the “amount” fields in the repeater field “orderlines”.</p>
<p>The available array functions are:</p>
<ul>
<li>sum()</li>
<li>average()</li>
<li>count()</li>
<li>min()</li>
<li>max()</li>
</ul>
<p>Note that anything after the dot (.) in the aggregate expression is an expression in itself. It’s perfectly OK to write a formula like: “Sum(orderlines.price * amount)”. This expression will walk over all lines in the “orderlines” repeater field, perform the calculation “price * amount” and return the sum of all lines.</p>
<p>Note that when working with aggregate functions, parentheses can not be used. If you need to aggregate a more complex calculation, you should add an extra field in the repeater group and let the aggregate function work on this extra field.</p>
<h4>Data type and calculation order</h4>
<p>Calculated fields works with the assumption that all fields are defined as numeric in the ACF editor. Using a text field in a formula WILL PRODUCE UNPREDICTABLE RESULTS.</p>
<p>Calculations are made as the custom field is stored to the database. To minimize the impact of performance, Calculated fields rely on field order. A formula field can only refer to fields ordered BEFORE itself. A formula field that refers to a field ordered after it WILL PRODUCE UNPREDICTABLE RESULTS.</p>


Calculated fields for ACF

A very pedantic developer. Thank You for your attention to detail.

Classwork!

Simple field math for Advanced Custom Fields.

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.

Calculated fields for ACF vs ACF Photo Gallery Field