### Composer Initialization Answers Example

Source: https://gravitywiz.com/documentation/installing-plugins-with-composer

An example of how to answer the prompts during `composer init` to generate the `composer.json` file.

```bash
Package name (<vendor>/<name>): ollivanders/magical-wordpress-site
Description []: My WordPress Wand Shop
Author: [Dave Smiff <your@email.com>, n to skip]: n
Minimum Stability []: // leave empty if not specified
Package Type []: // leave empty if not specified
License []: // leave empty if not specified
Would you like to define your dependencies (require) interactively [yes]? n
Would you like to define your dev dependencies (require-dev) interactively [yes]? n
Add PSR-4 autoload mapping? Maps namespace to the entered relative path. [src/, n to skip]: n
Do you confirm generation [yes]? yes
```

--------------------------------

### Example URL Generated by [gpqr]

Source: https://gravitywiz.com/documentation/gravity-forms-qr-code

This is an example of the URL that would be generated by the [gpqr] shortcode when format="url" is used.

```html
http://yoursite.local/wp-content/uploads/gravity_forms/gpqr-codes/25b22f6b66f94db6d1e889b9a85c7fe4.png
```

--------------------------------

### WP-CLI Command: Seed Database with Example Data

Source: https://gravitywiz.com/documentation/gravity-forms-bookings

Populate your database with example bookings, services, resources, forms, and entries. Use the --create-pages flag to also create necessary pages.

```bash
wp gp-bookings seed --create-pages
wp gp-bookings seed --skip-bookings
```

--------------------------------

### Log booking rescheduling details

Source: https://gravitywiz.com/documentation/gpb_rescheduled

This example demonstrates how to log the booking ID, new start, and new end times when a booking is rescheduled. It uses an anonymous function to handle the action.

```php
add_action('gpb_rescheduled', function($booking, $new_start, $new_end) {
    error_log("Booking {$booking->get_id()} rescheduled to {$new_start} - {$new_end}");
}, 10, 3);
```

--------------------------------

### Initialize Composer Project

Source: https://gravitywiz.com/documentation/installing-plugins-with-composer

Run this command in your site's root folder to start the Composer initialization process.

```bash
composer init
```

--------------------------------

### Set Custom Starting Page via Query String

Source: https://gravitywiz.com/documentation/gravity-forms-multi-page-navigation

Append '?gpmpn_page=X' to the form's URL to set a custom starting page. This requires the 'page' parameter to be set in the shortcode for security.

```url
http://mysite.com/my-form-page/?gpmpn_page=2
```

--------------------------------

### Set default values for user-facing filters

Source: https://gravitywiz.com/documentation/gpeb_selected_user_filters

This example demonstrates how to set default values for user-facing filters within the `gpeb_selected_user_filters` hook. It initializes filters based on predefined defaults or GET parameters.

```php
add_filter( 'gpeb_selected_user_filters', function( $filters, $form_id ) {
	$default_values = array(
		// Field/Input ID => Default Value
		1 => 'Second Choice'
	);

	$filters = array();

	foreach ( $default_values as $input_id => $default_value ) {
		$filters[ $input_id ] = rgars( $_GET, 'filters/' . $input_id, $default_value );
	}

	return $filters;
}, 10, 2 );
```

--------------------------------

### Restrict Bookings to Start 3 Days From Now

Source: https://gravitywiz.com/documentation/gpb_availability_start

Prevent same-day or next-day bookings by requiring at least 3 days advance notice. This example sets an absolute minimum date for bookings.

```php
add_filter( 'gpb_availability_start', function( $start, $service, $resource_ids ) {
    return \Carbon\CarbonImmutable::today()->addDays( 3 );
}, 10, 3 );
```

--------------------------------

### Install Dependencies from composer.lock

Source: https://gravitywiz.com/documentation/installing-plugins-with-composer

Recreate the project's dependencies on a new device or after cloning by running this command.

```bash
composer install
```

--------------------------------

### Supported Barcode Type Examples

Source: https://gravitywiz.com/documentation/gravity-forms-qr-code

Examples demonstrating the output for different supported barcode types using the ':type' modifier. These include PDF417, UPCA, and PHARMA.

```php
{My Field:1:qr,type[PDF417]}
```

```php
{My Field:1:qr,type[UPCA]}
```

```php
{My Field:1:qr,type[PHARMA]}
```

--------------------------------

### Sample composer.json Configuration

Source: https://gravitywiz.com/documentation/installing-plugins-with-composer

A sample `composer.json` file demonstrating the setup for Gravity Wiz plugins, including required packages and repository configuration.

```json
{
    "name": "ollivanders/magical-wordpress-site",
    "description": "My WordPress Wand Shop",
    "require": {
        "gravitywiz/gwreadonly": "^1.9",
        "gravitywiz/gp-populate-anything": "^2.1"
    },
    "repositories": {
        "gravitywiz": {
            "type": "composer",
            "url": "https://gravitywiz.com/composer"
        }
    },
    "config": {
        "allow-plugins": {
            "composer/installers": true
        }
    }
}
```

--------------------------------

### WP-CLI Command: Get Help for GP Bookings

Source: https://gravitywiz.com/documentation/gravity-forms-bookings

Displays detailed information about the wp gp-bookings command and its subcommands.

```bash
wp gp-bookings --help
```

--------------------------------

### Set Custom Starting Page via Shortcode

Source: https://gravitywiz.com/documentation/gravity-forms-multi-page-navigation

Use the 'page' parameter within the Gravity Forms shortcode to set a specific starting page for the form.

```shortcode
[gravityforms id="123" page="2"]
```

--------------------------------

### WP-CLI Command: Get Specific Booking Details

Source: https://gravitywiz.com/documentation/gravity-forms-bookings

Retrieve detailed information for a specific booking by providing its ID.

```bash
wp gp-bookings booking get bookingID
```

--------------------------------

### Global Filename Template Example

Source: https://gravitywiz.com/documentation/gpfr_filename

This example demonstrates how to set a global filename template using `gpfr_filename_template`. It places files in an entry-specific subfolder and appends a count to the filename. Requires GP File Renamer v1.0.5+.

```php
<?php
/**
 * Gravity Perks // File Renamer // Global Filename Template
 * https://gravitywiz.com/documentation/gravity-forms-file-renamer/
 *
 * This snippet puts all files in an entry-specific subfolder and increments the filename with its count.
 *
 * Requires GP File Renamer v1.0.5+.
 */
add_filter( 'gpfr_filename_template', function ( $template, $filename, $form, $field, $entry ) {
	return '{entry:id}/{filename}-{i}';
}, 10, 5 );
```

--------------------------------

### Display Booking Start Date

Source: https://gravitywiz.com/documentation/gravity-forms-bookings

Use the `:startDate` modifier with the `{gpb_booking}` merge tag to display only the booking's start date.

```php
{gpb_booking:startDate}
```

--------------------------------

### Conditionally Show GP Populate Anything Integration

Source: https://gravitywiz.com/documentation/gcgs_show_gppa_integration

Use this filter to control whether the GP Populate Anything integration callout is displayed. By default, it is shown if Populate Anything is installed. Returning `true` ensures the callout is always shown, regardless of installation status.

```php
add_filter( 'gcgs_show_gppa_integration', '__return_true' );
```

--------------------------------

### Add Support for PDF_417 and UPC_A Barcode Formats

Source: https://gravitywiz.com/documentation/gpqr_scanner_config

This example demonstrates how to extend the supported barcode formats for the QR Code scanner to include PDF_417 and UPC_A. Ensure you have the Gravity Perks Custom JavaScript plugin installed.

```javascript
/**
 * Gravity Perks // GP QR Code // Add Support for PDF_417 and UPC_A
 * https://gravitywiz.com/documentation/gravity-forms-qr-code/
 *
 * Instructions:
 *
 * 1. Install this snippet with our free Custom JavaScript plugin.
 *    https://gravitywiz.com/gravity-forms-code-chest/
 */
window.gform.addFilter( 'gpqr_scanner_config', function( config, instance, formats ) {
	config['formatsToSupport'] = [ formats.QR_CODE, formats.PDF_417, formats.UPC_A ];
	return config;
} );
```

--------------------------------

### Navigate to First Page of Gravity Form

Source: https://gravitywiz.com/documentation/gravity-forms-multi-page-navigation

Example of an HTML link to navigate back to the first page of a multi-page Gravity Form.

```html
<a href="#1" class="gpmpn-page-link">Head Back to Page #1</a>
```

--------------------------------

### Example: Enable User-Agent Checking for Form ID 123

Source: https://gravitywiz.com/documentation/gpcb_validate_user_agent

This example demonstrates how to enable user-agent checking for a specific form (ID 123) using the gpcb_validate_user_agent filter. Ensure you update '123' to your target form's ID.

```php
<?php
/**
 * Gravity Perks // Blocklist // Enable User-Agent Checking
 * https://gravitywiz.com/documentation/gravity-forms-blocklist/
 */
// Update "123" to the form ID.
add_filter( 'gpcb_validate_user_agent_123', '__return_true' );
```

--------------------------------

### Require a Gravity Wiz Plugin

Source: https://gravitywiz.com/documentation/installing-plugins-with-composer

Install a specific Gravity Wiz plugin as a dependency in your project.

```bash
composer require gravitywiz/**[PLUGIN_NAME]**
```

--------------------------------

### Disable Async on Google Sheets Feeds

Source: https://gravitywiz.com/documentation/gravity-connect-google-sheets

Disables the asynchronous processing of GC Google Sheets feeds, ensuring they run within the same request. Install per the standard snippet installation guide.

```php
add_filter( 'gcpp_google_sheets_feed_async', '__return_false' );
```

--------------------------------

### Navigate to Second Page of Gravity Form

Source: https://gravitywiz.com/documentation/gravity-forms-multi-page-navigation

Example of an HTML link to navigate to the second page of a multi-page Gravity Form.

```html
<a href="#2" class="gpmpn-page-link">Get On Back to Page #2</a>
```

--------------------------------

### PHP Snippet Example

Source: https://gravitywiz.com/documentation/managing-snippets

Most WordPress snippets are written in PHP. PHP snippets typically start with '<?php' and have filenames ending in .php.

```php
<?php
```

--------------------------------

### JSONPath Array Slice

Source: https://gravitywiz.com/documentation/gravity-connect-api-alchemist

Extract a specific range of elements from an array. This example gets the first two elements from the 'data' array.

```jsonpath
$.data[0:2]
```

--------------------------------

### JSONPath Deep Wildcard

Source: https://gravitywiz.com/documentation/gravity-connect-api-alchemist

Retrieve a property from all nested objects within arrays. This example gets the 'name' of every product in every order.

```jsonpath
$.orders[*].products[*].name
```

--------------------------------

### JSONPath All Array Items Access

Source: https://gravitywiz.com/documentation/gravity-connect-api-alchemist

Retrieve a specific property from all objects within an array. This example gets the 'name' from every object in the 'results' array.

```jsonpath
$.results[*].name
```

--------------------------------

### Logging Booking Status Transitions

Source: https://gravitywiz.com/documentation/gpb_status_transitioned

This example demonstrates how to log the old and new status of a booking whenever its status changes. It utilizes the provided booking object and status parameters to record the transition.

```php
add_action('gpb_status_transitioned', function($booking, $new_status, $old_status) {
    error_log("Booking {$booking->get_id()} status changed: {$old_status} -> {$new_status}");
}, 10, 3);
```

--------------------------------

### JSONPath Slice with Step

Source: https://gravitywiz.com/documentation/gravity-connect-api-alchemist

Extract elements from an array with a specified step. This example gets every second book title within the first three books in 'store.book'.

```jsonpath
$.store.book[0:3:2].title
```

--------------------------------

### JSONPath Conditional Filtering

Source: https://gravitywiz.com/documentation/gravity-connect-api-alchemist

Filter array elements based on a condition and retrieve a specific property from the matching elements. This example gets the 'id' from 'items' where the 'active' property is true.

```jsonpath
$.items[?(@.active)].id
```

--------------------------------

### Basic Usage of gpls_before_query

Source: https://gravitywiz.com/documentation/gpls_before_query

This snippet demonstrates the basic structure for hooking into the 'gpls_before_query' action. It shows how to register a custom function that receives the GPLS_RuleTest object.

```php
add_action( 'gpls_before_query', 'my_custom_function' );
```

--------------------------------

### Apply gspc_init_args Globally

Source: https://gravitywiz.com/documentation/gspc_init_args

Use this filter to modify the initialization arguments for the Product Configurator across your entire site. Applied globally.

```php
add_filter( 'gspc_init_args', 'my_custom_function' );
```

--------------------------------

### List Available Gravity Wiz Packages

Source: https://gravitywiz.com/documentation/installing-plugins-with-composer

Use this command to see all available Gravity Wiz plugins in the Composer repository.

```bash
composer show -all "gravitywiz/*"
```

--------------------------------

### Register Additional Database for Populate Anything

Source: https://gravitywiz.com/documentation/gravity-forms-populate-anything

Use this snippet to register an additional SQL database with custom credentials for Populate Anything to pull data from.

```php
add_filter( 'gppa_database_connections', function( $connections ) {
    $connections[] = array(
        'label' => 'My Other Database',
        'host'  => 'localhost',
        'user'  => 'username',
        'password' => 'password',
        'database' => 'database_name'
    );
    return $connections;
} );
```

--------------------------------

### Set default page to the second page

Source: https://gravitywiz.com/documentation/gpmpn_default_page

This example sets the default page to the second page of the form, overriding any shortcode or query string settings. Update the return value to change the starting page.

```php
<?php
/**
 * Gravity Perks // Multi-Page Navigation // Change Default Form Page
 * https://gravitywiz.com/documentation/gravity-forms-multi-page-navigation/
 */
add_filter( 'gpmpn_default_page', function( $page ) {
	// Update "2" to the page at which the form should start. "2" would start the form on the second page.
	return 2;
} );
```

--------------------------------

### Add Custom Reason for Rejecting Emails

Source: https://gravitywiz.com/documentation/gpev_validation_result

This example demonstrates how to add a custom validation reason if an email address starts with 'admin@'. It hooks into the general `gpev_validation_result` filter and returns the modified validation result.

```php
add_filter( 'gpev_validation_result', function( $validation_result, $value, $field, $form, $validator ) {
    if ( strpos( $value, 'admin@' ) === 0 ) {
        $validation_result->add_reason( 'admin_role_not_allowed', 'Admin emails are not allowed.' );
    }

    return $validation_result;
}, 10, 5 );
```

--------------------------------

### Set JPEG Quality to 100% for All Uploaded Images

Source: https://gravitywiz.com/documentation/gpfup_jpeg_quality

This example demonstrates how to set the JPEG quality to 100% for all images uploaded through File Upload Pro. Ensure you have the Custom Javascript for Gravity Forms plugin installed.

```javascript
/**
 * Gravity Perks // File Upload Pro // Set JPEG Quality for all Uploaded Images
 * https://gravitywiz.com/documentation/gravity-forms-file-upload-pro/
 *
 * Instructions:
 *   1. Install our free Custom Javascript for Gravity Forms plugin.
 *      Download the plugin here: https://gravitywiz.com/gravity-forms-code-chest/
 *   2. Copy and paste the snippet into the editor of the Custom Javascript for Gravity Forms plugin.
 */
window.gform.addFilter( 'gpfup_jpeg_quality', function () {
	// Update '1' to the desired quality. 1 represents 100%.
	return 1;
} );
```

--------------------------------

### Usage of gpld_after_set_min_date Action

Source: https://gravitywiz.com/documentation/gpld_after_set_min_date

This snippet demonstrates how to hook into the `gpld_after_set_min_date` action to execute a custom function when a minimum date is set.

```javascript
gform.addAction( 'gpld_after_set_min_date', 'my_custom_function' );
```

--------------------------------

### Reset Unique ID Sequence at Threshold

Source: https://gravitywiz.com/documentation/gpui_unique_id

This example demonstrates how to reset a sequentially generated Unique ID when it reaches a specific number. Update the form ID, field ID, starting number, and reset threshold as needed.

```php
<?php
/**
 * Gravity Perks // Unique ID // Reset Sequence at Specific Threshold
 * https://gravitywiz.com/documentation/gravity-forms-unique-id/
 *
 * Reset the sequence of a Sequential Unique ID field when the sequence reaches a specified number.
 */
add_filter( 'gpui_unique_id', function( $unique, $form_id, $field_id ) {

	// Update "123" to your form ID and "4" to the ID of your Unique ID field.
	if ( $form_id == 123 && $field_id == 4 ) {

		// Update "1" to the number the sequence should be reset to when the threshold is reached.
		$starting_number = 1;

		// Update "99" to the threshold at which the sequence should be reset.
		$reset_number = 99;

		if ( $unique == $reset_number ) {
			gp_unique_id()->set_sequential_starting_number( $form_id, $field_id, $starting_number - 1 );
		}
	}

	return $unique;
}, 10, 3 );

```

--------------------------------

### Registering a Callback for gpb_status_transitioned

Source: https://gravitywiz.com/documentation/gpb_status_transitioned

Use this action to hook into the booking status transition process globally. Ensure your callback function is defined before adding the action.

```php
add_action( 'gpb_status_transitioned', 'my_custom_function' );
```

--------------------------------

### Set Limit Period by User Meta

Source: https://gravitywiz.com/documentation/gpls_before_query

This example shows how to dynamically set the time period for submission limits based on a user's meta data. Ensure the form ID and user meta key are updated to match your specific setup.

```php
<?php
/**
 * Gravity Perks // Limit Submissions // Set Limit Period by User Meta
 * https://gravitywiz.com/documentation/gravity-forms-limit-submissions/
 */
add_action( 'gpls_before_query', function( $ruletest ) {
	global $wpdb;

	// Update "123" to your form ID.
	if ( $ruletest->form_id != 123 ) {
		return;
	}

	// Update "subscription_start_date" to your user meta key.
	$subscription_start_date = get_user_meta( get_current_user_id(), 'subscription_start_date', true );
	$time_period_sql         = $wpdb->prepare( 'date_created BETWEEN %s AND DATE_ADD( CURDATE(), INTERVAL 1 DAY )', $subscription_start_date );
	$ruletest->where[]       = $time_period_sql;

} );
```

--------------------------------

### Attach a File using gpeu_email_options

Source: https://gravitywiz.com/documentation/gpeu_email_options

This example demonstrates how to add an attachment to an email by modifying the 'attachment' key within the email options array. Ensure the file path is correct.

```php
add_filter( 'gpeu_email_options', function( $options, $form ) {
  $options['attachment'] = array( 'path/to/file' );
  return $options;
}, 10, 2 );
```

--------------------------------

### Display User Data with Entry Blocks

Source: https://gravitywiz.com/documentation/gravity-forms-entry-blocks

Utilize the `{created_by:[meta_key]}` merge tag to display user data, including custom meta keys, from the entry creator. For example, `{created_by:first_name}` displays the user's first name. More details are available in the merge tag usage guide.

```php
{created_by:first_name}
```

--------------------------------

### Grant Access to Administrators

Source: https://gravitywiz.com/documentation/gpsa_has_access

This example demonstrates how to automatically grant access to all content for users with the 'administrator' role. This is useful for ensuring administrators can always view protected content.

```php
<?php
/**
 * Gravity Perks // Submit to Access // Auto-allow Access for Administrators
 * https://gravitywiz.com/documentation/gravity-forms-submit-to-access/
 */
add_filter( 'gpsa_has_access', function( $has_access ) {
	if ( current_user_can( 'administrator' ) ) {
		return true;
	}

	return $has_access;
} );

```

--------------------------------

### Log All Booking Status Transitions

Source: https://gravitywiz.com/documentation/gpb_pre_status_transition

This example logs every booking status transition to the PHP error log. It captures the booking ID, old status, and new status for auditing purposes.

```php
add_filter('gpb_pre_status_transition', function($allowed, $new_status, $old_status, $booking) {
    error_log("Booking {$booking->get_id()} transitioning from {$old_status} to {$new_status}");
    return $allowed;
}, 10, 4);
```

--------------------------------

### Configure Composer Authentication

Source: https://gravitywiz.com/documentation/installing-plugins-with-composer

Set up basic authentication for the Gravity Wiz Composer repository using your license keys and registered site URL.

```bash
composer config -g http-basic.gravitywiz.com **"[LICENSE_KEY(S)]" "[REGISTERED_SITE]"**
```

--------------------------------

### Customize Out of Stock Message

Source: https://gravitywiz.com/documentation/gpi_out_of_stock_message

Example of how to return a custom out-of-stock message using the `gpi_out_of_stock_message` filter. This example sets a static message.

```php
add_filter( 'gpi_out_of_stock_message', function(){
	return 'Sorry, this item is out of stock.';
} );
```

--------------------------------

### WP-CLI Command: List All Bookings

Source: https://gravitywiz.com/documentation/gravity-forms-bookings

Use this command to retrieve a list of all bookings managed by GP Bookings.

```bash
wp gp-bookings booking list
```

--------------------------------

### Calculate Date Difference Including Both Start and End Dates

Source: https://gravitywiz.com/documentation/gravity-forms-date-time-calculator

Use `includeStart=true` and `includeEnd=true` with `datediff()` to count both the start and end dates in the calculation.

```php
datediff( F1, F2, unit='days', includeStart=true, includeEnd=true )
```

--------------------------------

### Add Live Merge Tag to Whitelist

Source: https://gravitywiz.com/documentation/gppa_lmt_whitelist

This example demonstrates how to add a specific Live Merge Tag (e.g., '{ip}') to the whitelist for a given form. It ensures that the merge tag is recognized and can be used.

```php
<?php
/**
 * Gravity Perks // Populate Anything // Add Live Merge Tag to Whitelist
 * https://gravitywiz.com/documentation/gravity-forms-populate-anything/
 */
add_filter( 'gppa_lmt_whitelist', function( $whitelist, $form ) {
	$merge_tag = '{ip}';

	$whitelist[ $merge_tag ] = wp_create_nonce( 'gppa-lmt-' . $form['id'] . '-' . $merge_tag );

	return $whitelist;
}, 10, 2 );
```

--------------------------------

### Basic [gpqr] Shortcode Usage

Source: https://gravitywiz.com/documentation/gravity-forms-qr-code

Use this shortcode to combine multiple fields or static text into a QR code. This example adds a static prefix to the ticket ID.

```php
[gpqr]Ticket Number: {Ticket ID:3}[/gpqr]
```

--------------------------------

### Filter Forms by ID

Source: https://gravitywiz.com/documentation/gpeu_forms

This example demonstrates how to limit the available forms to a specific set of IDs. Replace the example IDs with your actual form IDs.

```php
add_filter( 'gpeu_forms', function ( $forms ) {

	$allowed_forms = array( 123, 456, 789 ); // Replace with Form IDs

	$limited_forms = array();

	foreach ( $forms as $form ) {
		if ( in_array( $form['id'], $allowed_forms ) ) {
			array_push( $limited_forms, $form );
		}
	}

	return $limited_forms;
} );
```

--------------------------------

### Set Default Starting Page via PHP Filter

Source: https://gravitywiz.com/documentation/gravity-forms-multi-page-navigation

Use the 'gpmpn_default_page' filter to programmatically set the default starting page for multi-page forms.

```php
add_filter( 'gpmpn_default_page', function( $page ) {
	return 2;
} );
```

--------------------------------

### Increase Starting Row ID by 1

Source: https://gravitywiz.com/documentation/gpnf_row_id_value

Customize the starting Row ID from the default '1' to '2' by adding 1 to the existing rowId value.

```javascript
window.gform.addFilter('gpnf_row_id_value', function(rowId) {
	return rowId + 1;
});
```

--------------------------------

### Hook into gpeb_before_query_entries Action

Source: https://gravitywiz.com/documentation/gpeb_before_query_entries

Use this action to run custom code before Gravity Forms entries are queried. It provides access to the GF_Queryer object for potential modifications.

```php
add_action( 'gpeb_before_query_entries', 'my_custom_function' );
```

--------------------------------

### Apply `gpb_availability_start` Filter Globally

Source: https://gravitywiz.com/documentation/gpb_availability_start

This snippet shows how to apply the `gpb_availability_start` filter globally to all availability checks. It uses a custom function to define the restriction.

```php
add_filter( 'gpb_availability_start', 'my_custom_function' );
```

--------------------------------

### Customize inventory available message

Source: https://gravitywiz.com/documentation/gpi_inventory_available_message

Example of a custom function to change the inventory available message format. This example sets a specific string format for the message.

```php
add_filter( 'gpi_inventory_available_message', function() {
   return "({available} {item|items} still in stock)";
} );
```

--------------------------------

### Hook into `gpeb_trash_entry` Action

Source: https://gravitywiz.com/documentation/gpeb_trash_entry

Use this action to execute custom code before an entry is trashed. The function hooked will receive the entry data as an argument.

```php
add_action( 'gpeb_trash_entry', 'my_custom_function' );
```

--------------------------------

### Set 60-Minute Blocks for Specific Service on Fridays

Source: https://gravitywiz.com/documentation/gpb_block_size

This example customizes the block size to 60 minutes when the service ID is 123 and the day is Friday. It demonstrates conditional logic based on service and date.

```php
add_filter( 'gpb_block_size', function( $block_size, $date, $service ) {
    if ( $service->get_id() === 123 && date( 'N', strtotime( $date ) ) === '5' ) {
        return 60;
    }
    return $block_size;
}, 10, 3 );
```

--------------------------------

### Custom Inventory Exhausted Message Example

Source: https://gravitywiz.com/documentation/gpi_inventory_exhausted_message

This example demonstrates how to return a custom string for the inventory exhausted message. This filter is available since Gravity Forms Inventory 1.0-beta-3.42.

```php
add_filter( 'gpi_inventory_exhausted_message', function() {
   return "Sorry, item out of stock.";
} );
```

--------------------------------

### Define License Keys in wp-config.php

Source: https://gravitywiz.com/documentation/can-i-download-perks-via-an-api

Define license key constants in wp-config.php before installation to automatically pre-populate them. This method applies to Perks, Connect, and Shop licenses.

```php
define( 'SPELLBOOK_KEY_PERKS', 'YOUR-GRAVITY-PERKS-LICENSE-KEY-HERE' );
define( 'SPELLBOOK_KEY_CONNECT', 'YOUR-GRAVITY-CONNECT-LICENSE-KEY-HERE' );
define( 'SPELLBOOK_KEY_SHOP', 'YOUR-GRAVITY-SHOP-LICENSE-KEY-HERE' );
```

--------------------------------

### Populate All Results

Source: https://gravitywiz.com/documentation/gravity-forms-populate-anything

Enables Populate Anything to populate all found results, not just the first one.

```php
add_filter( 'gppa_limit_YOUR_FIELD_ID', '__return_false' );
```

--------------------------------

### Remove 'Start New Draft' Link

Source: https://gravitywiz.com/documentation/gravity-forms-advanced-save-and-continue

Use this filter to remove the 'Start New Draft' link. To apply to all forms, use 'gpasc_new_draft_link_text'. To apply to a specific form, append the form ID.

```php
add_filter( 'gpasc_new_draft_link_text', '__return_false' );
```

```php
add_filter( 'gpasc_new_draft_link_text_FORMID', '__return_false' );
```

--------------------------------

### Example Auto-Progression Condition for Text Fields

Source: https://gravitywiz.com/documentation/gppt_auto_progress_support_conditions

This example demonstrates a condition for 'text' field types, requiring the Input Mask feature to be enabled for auto-progression support. It's provided as an illustration of how a callback function works.

```php
array(
	'type' => 'text',
	'callback' => array( $this, 'auto_progress_condition_text' ),
)
```

```php
public function auto_progress_condition_text( $field ) {
	return $field['inputMask'] == true;
}
```

--------------------------------

### Register gpb_pre_status_transition Filter

Source: https://gravitywiz.com/documentation/gpb_pre_status_transition

This is the basic structure for hooking into the gpb_pre_status_transition filter. Replace 'my_custom_function' with your actual callback function name.

```php
add_filter( 'gpb_pre_status_transition', 'my_custom_function' );
```

--------------------------------

### Count Weekdays Between Two Dates

Source: https://gravitywiz.com/documentation/gravity-forms-date-time-calculator?migration=1

Use the `{weekdays:}` merge tag to count the number of weekdays between two specified Date fields. The count includes the start date. Subtract 1 to exclude the start date.

```gravityforms
{weekdays:{Start Date:1},{End Date:2}}
```

--------------------------------

### Change Validation Message for a Specific Field (Example)

Source: https://gravitywiz.com/documentation/gpls_field_validation_message

This example demonstrates how to change the GP Limit Submission validation message for field ID `4` in form ID `123`. Update the IDs and the message string as needed.

```php
<?php
/**
 * Gravity Perks // Limit Submission // Change Validation Message for a Specific Field
 * https://gravitywiz.com/documentation/gravity-forms-limit-submissions/
 */
// Update "123" to your form ID and "4" to your field ID.
add_filter( 'gpls_field_validation_message_123_4', function( $message ) {
	return 'Example validation message.';
} );

```

--------------------------------

### Apply Service-Specific Booking Windows

Source: https://gravitywiz.com/documentation/gpb_availability_end

Implement different booking advance limits for different services. This example shows how to apply a 1-year limit for service ID 123 and a 2-month limit for service ID 456, falling back to the default limit for other services.

```php
add_filter( 'gpb_availability_end', function( $end, $service, $resource_ids ) {
    // Vacation rentals: 1 year advance
    if ( $service->get_id() === 123 ) {
        return \Carbon\CarbonImmutable::today()->addYear();
    }
    // Haircuts: 2 months advance
    if ( $service->get_id() === 456 ) {
        return \Carbon\CarbonImmutable::today()->addMonths( 2 );
    }
    return $end;
}, 10, 3 );
```

--------------------------------

### Restrict Bookings When a Specific Resource is Selected

Source: https://gravitywiz.com/documentation/gpb_availability_start

Apply different restrictions based on which resource is being booked. This example requires 1 week advance notice if resource ID 456 is selected.

```php
add_filter( 'gpb_availability_start', function( $start, $service, $resource_ids ) {
    // Premium resource requires 1 week advance notice
    if ( in_array( 456, $resource_ids ) ) {
        return \Carbon\CarbonImmutable::today()->addWeeks( 1 );
    }
    return $start;
}, 10, 3 );
```

--------------------------------

### Count Weekend Days Between Two Dates

Source: https://gravitywiz.com/documentation/gravity-forms-date-time-calculator?migration=1

Use the `{weekendDays:}` merge tag to count the number of weekend days between two specified Date fields. The count includes the start date. Subtract 1 to exclude the start date.

```gravityforms
{weekendDays:{Start Date:1},{End Date:2}}
```

--------------------------------

### Sample Gravity Forms HTML Structure

Source: https://gravitywiz.com/documentation/gravity-forms-popups

Provides a sample HTML structure for a Gravity Form, illustrating the common classes and elements used by the plugin, such as `.gform_wrapper`, `.gform_body`, `.gfield`, and `.gform_footer`.

```html
<div class="gform_wrapper gform-theme" id="gform_wrapper_2">
  <form method="post" id="gform_2">
    <div class="gform_body">
      <div class="gform_fields">
        <div class="gfield gfield--type-text">
          <label class="gfield_label">Email</label>
          <div class="ginput_container">
            <input type="email" class="large">
          </div>
        </div>
      </div>
    </div>
    <div class="gform_footer">
      <input type="submit" class="gform_button button" value="Submit">
    </div>
  </form>
</div>
```

--------------------------------

### Set Orphaned Entry Expiration Duration

Source: https://gravitywiz.com/documentation/gpnf_expiration_modifier

This snippet demonstrates setting custom expiration durations for orphaned entries. The first example sets expiration to 30 days (1 month), and the second example sets it to never expire by returning a very large value.

```php
<?php
/**
 * Gravity Perks // Nested Forms // Set Orphaned Entry Expiration Duration
 * https://gravitywiz.com/documentation/gravity-forms-nested-forms/
 *
 * Modify how long entries submitted from a nested form should be saved before being moved to the trash.
 */
// Expire orphaned entries after 30 days (1 month).
add_filter( 'gpnf_expiration_modifier', function() {
	return MONTH_IN_SECONDS;
} );

// Never expire orphaned entries.
add_filter( 'gpnf_expiration_modifier', function() {
	return 100 * YEAR_IN_SECONDS;
} );
```

--------------------------------

### Display Booking Resources

Source: https://gravitywiz.com/documentation/gravity-forms-bookings

Use the `{gpb_resource}` merge tag to display the name(s) of the resource(s) booked. Use the `:format[comma]` modifier to list multiple resources separated by commas.

```php
{gpb_resource}
```

```php
{gpb_resource:format[comma]}
```

--------------------------------

### Disable Nested Form Field Dynamic Values (Example)

Source: https://gravitywiz.com/documentation/gpnf_should_use_static_value

This example demonstrates disabling dynamic values for Nested Form fields. When child entries are populated into a different parent form, this ensures they remain attached to the new parent entry while also staying linked to the original parent.

```php
<?php
/**
 * Gravity Perks // Nested Forms // Disable Nested Form Field Dynamic Values
 * https://gravitywiz.com/documentation/gravity-forms-nested-forms/
 *
 * When existing child entries are populated into the nested form field of a different parent form,
 * it will no longer be attached to the original parent entry when the new parent form is submitted.
 * Use this snippet to attach the child entries to the new parent entry and also allow the
 * child entries to remain attached to the original parent entry.
 */
add_filter( 'gpnf_should_use_static_value', '__return_true' );

```

--------------------------------

### Calculate Age in Months

Source: https://gravitywiz.com/documentation/gravity-forms-date-time-calculator

To get the age in months, specify `unit='months'` in the `age()` function.

```php
age( F1, unit='months' )
```

--------------------------------

### Usage of GPLP Preview Template Filter

Source: https://gravitywiz.com/documentation/gplp_preview_template

This is the basic structure for adding the `gplp_preview_template` filter. The filter expects the absolute path to the desired template file.

```php
add_filter( 'gplp_preview_template', $template );

```

--------------------------------

### Backfill Easy Passthrough Tokens for Existing Entries

Source: https://gravitywiz.com/documentation/gravity-forms-easy-passthrough

Use the GWiz Batcher helper plugin to add Easy Passthrough tokens to existing entries. This involves modifying the plugin's PHP file to specify form IDs, uploading the modified plugin, activating it, running the batch process, and then deactivating the plugin.

```php
$form_ids_to_backfill = array( 1, 2, 3 );
```

--------------------------------

### Round Function Example

Source: https://gravitywiz.com/documentation/gravity-forms-advanced-calculations

Rounds a number to the nearest integer. This is a standard rounding function for general use.

```gravityforms
round( 12.7 )
```

```gravityforms
round( F2 )
```

```gravityforms
round( 8.68 )
```

--------------------------------

### Deprecated Snippet: Populate All Query Results As Comma-delimited List

Source: https://gravitywiz.com/documentation/gppa_get_input_values

This example is noted as deprecated and directs users to a newer version. It was intended for populating query results as a comma-delimited list.

```php
<?php
/**
 * This snippet has evolved! 
 * Find the new version of this snippet here:
 * https://gravitywiz.com/snippet-library/gppa-populate-all-results/
 */

```

--------------------------------

### Update Plugins with Composer

Source: https://gravitywiz.com/documentation/installing-plugins-with-composer

Update installed plugins to the latest versions allowed by the version constraints in `composer.json`.

```bash
composer update
```

--------------------------------

### Add Menu Order Property for Post Object

Source: https://gravitywiz.com/documentation/gppa_object_type_properties

This example demonstrates how to add the 'menu_order' property to the available properties for the 'post' object type. This allows 'Menu Order' to be used for filtering and ordering posts.

```php
<?php
/**
 * Gravity Perks // GP Populate Anything // Add Menu Order Property for Post Object
 * https://gravitywiz.com/documentation/gravity-forms-populate-anything/
 */
add_filter( 'gppa_object_type_properties_post', function( $props ) {
	global $wpdb;
	$props['menu_order'] = array(
		'label'    => esc_html__( 'Menu Order', 'gp-populate-anything' ),
		'value'    => 'menu_order',
		'callable' => array( gp_populate_anything()->get_object_type( 'post' ), 'get_col_rows' ),
		'args'     => array( $wpdb->posts, 'menu_order' ),
		'orderby'  => true,
	);
	return $props;
} );
```