### Example iframe HTML

Source: https://docs.mylistingtheme.com/article/embedding-an-iframe

This is an example of an iframe tag that can be used to embed content. Ensure the src attribute is correctly set.

```html
<iframe width="560" height="315" src="https://www.youtube.com/embed/dQw4w9WgXcQ?si=dtEgH-Un1HVB63gS" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe>
```

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

### How to use a code snippet (PHP)

Source: https://docs.mylistingtheme.com/explore?pg=3

Learn how to implement custom PHP code snippets in your MyListing theme. This is useful for adding specific functionalities not covered by default theme options.

```php
<?php

/**
 * MyListing - Hide past events.
 *
 * @param array $args Query args.
 */
function mylisting_hide_past_events( $args ) {
    if ( ! is_array( $args ) ) {
        return $args;
    }

    $args['meta_query'] = array(
        array(
            'key'     => 'event_date',
            'value'   => date( 'Y-m-d H:i:s' ),
            'compare' => '>=',
            'type'    => 'DATETIME',
        ),
    );

    return $args;
}

add_filter( 'mylisting/query-args/events', 'mylisting_hide_past_events' );
```

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

### WooCommerce Notify Admin on User Registration

Source: https://docs.mylistingtheme.com/author/admin/page/4

This code snippet sends an email notification to the admin when a new user registers via WooCommerce. Ensure WooCommerce is installed and configured.

```php
add_action( 'woocommerce_created_customer', 'wc_notify_admin_on_new_user' );

function wc_notify_admin_on_new_user( $customer_id ) {
    // Get the admin email address
    $admin_email = get_option( 'admin_email' );

    // Get the user object
    $user = wc_get_user_by_id( $customer_id );

    // Construct the email subject and body
    $subject = sprintf( __( 'New User Registered: %s', 'woocommerce' ), $user->user_login );
    $body = sprintf( __( 'A new user has registered on your site: %s', 'woocommerce' ), $user->user_login );

    // Send the email notification
    wp_mail( $admin_email, $subject, $body );
}
```

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

### Add WhatsApp Quick Action Link

Source: https://docs.mylistingtheme.com/article/single-page-tab-cover-style-cover-details-and-quick-actions

Use this URL format to create a custom quick action that opens WhatsApp with a pre-filled phone number. Ensure the 'Whatsapp number' custom field is set up correctly in the 'Fields' tab.

```html
https://api.whatsapp.com/send?phone=[[whatsapp-number]]
```

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

### Show main menu icons on desktop

Source: https://docs.mylistingtheme.com/explore?pg=4&sort=latest&type=article

Display main menu icons on desktop view. This snippet enhances navigation by visually representing menu items.

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

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

### HTML for Copy Link Button

Source: https://docs.mylistingtheme.com/article/add-copy-link-button-to-the-quick-actions-section

Add this HTML to create the 'Copy link' button within the Quick Actions settings. It uses a specific class for styling and a link to a placeholder ID.

```html
<a class="c27-copy-link" href="[[:url]]" title="Copy link"><i class="fa fa-clone"></i><span>Copy link</span></a>
```

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

### Enable Main Menu Icons on Desktop

Source: https://docs.mylistingtheme.com/article/show-main-menu-icons-on-desktop

Use this CSS to display menu icons on desktop screens. Add this code to your theme's custom CSS section.

```css
@media only screen and (min-width : 1201px) {
ul.main-nav li a>i {
display: inline-block;
padding-right: 5px;
}
}
```

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

### Prevent Skipping Checkout for Free Listing Packages

Source: https://docs.mylistingtheme.com/article/do-not-skip-checkout-for-free-0-listing-packages

Use this filter in your theme's functions.php file to ensure that users go through the checkout process for all listing packages, including free ones. This prevents users from bypassing checkout for $0 packages.

```php
add_filter( 'mylisting\packages\free\skip-checkout', '__return_false' );
```

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

### Use PHP Snippet for Custom Functionality

Source: https://docs.mylistingtheme.com/explore?pg=3&sort=latest&type=article

This snippet demonstrates how to use PHP for custom theme modifications. Ensure you understand the implications before adding custom code.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

### Add 'Copy link' button to 'Quick Actions'

Source: https://docs.mylistingtheme.com/explore?pg=4

Adds a 'Copy link' button to the 'Quick Actions' section of a listing. This snippet is useful for providing users with an easy way to share listing links.

```php
add_action( 'mylisting_quick_actions', function( $post_id ) {
    $link = get_permalink( $post_id );
    printf( '<a href="#" data-clipboard-text="%1$s" class="cts-copy-link button button-secondary"><i class="fa fa-link"></i> %2$s</a>', esc_url( $link ), esc_html__( 'Copy link', 'my-listing' ) );
}, 20 );
```

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

### Bulk Geolocate Listings PHP Snippet

Source: https://docs.mylistingtheme.com/article/after-importing-listings-they-are-not-shown-in-explore-page

Add this snippet to your child theme's functions.php file. It hooks into the 'init' action and, when triggered by a specific URL parameter, iterates through listings that lack geolocation data and attempts to geolocate them using the MyListing geocoder. Ensure your Google Maps API is working and addresses are imported correctly.

```php
<?php 
add_action( 'init', function() {
 if ( empty( $_GET['geolocate_listings'] ) || ! current_user_can( 'administrator' ) ) {
 return;
 }
 $next_data = 50;
 $offset = 0;
 do {
 $listings = (array) get_posts( [
 'post_type' => 'job_listing',
 'offset' => $offset,
 'posts_per_page' => $next_data,
 'post_status' => ['publish', 'private', 'expired'],
 'meta_query' => [
 'relation' => 'OR',
 [ 'key' => 'geolocation_lat', 'value' => '' ],
 [ 'key' => 'geolocation_long', 'value' => '' ],
 [ 'key' => 'geolocation_lat', 'compare' => 'NOT EXISTS' ],
 [ 'key' => 'geolocation_long', 'compare' => 'NOT EXISTS' ],
 ],
 ] );
 printf(
 "Fetching geolocation data from listing %d to %d <br />",
 $offset + 1,
 $offset + $next_data
 );
 flush();
 ob_flush();
 foreach ( $listings as $listing ) {
 if ( ! ( $location = get_post_meta( $listing->ID, '_job_location', true ) ) ) {
 printf( '<p style="color: #8e8e8e;">Skipping geolocation for listing #%d (missing address)</p>', $listing->ID );
 continue;
 }
 $geocoded = mylisting()->geocoder()->save_location( $listing->ID, $location );
 if ( $geocoded !== false ) {
 printf( '<p style="color: green;">Geolocation successful for listing #%d (%s)</p>', $listing->ID, $location );
 continue;
 }
 printf( '<p style="color: red;">Failed to geolocate listing #%d (%s)</p>', $listing->ID, $location );
 }
 $offset = ( ! $offset ) ? $next_data : $offset + $next_data;
 } while( ! empty( $listings ) );
 exit('All listings are updated, you can close this window.');
 }, 250 );
```

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

### Add 'Copy link' button to Quick Actions

Source: https://docs.mylistingtheme.com/explore?pg=4&sort=latest&type=article

Add a 'Copy link' button to the 'Quick Actions' section of a listing. This snippet is useful for providing users with an easy way to share listing URLs.

```php
add_action( 'mylisting/listing/quick-actions', function( $post_id ) {
    $link = get_permalink( $post_id );
    if ( ! $link ) {
        return;
    }
    ?>
    <li>
        <a href="#" class="copy-to-clipboard" data-clipboard-text="<?php echo esc_url( $link ); ?>">
            <i class="mi mi-link"></i>
            <span>Copy Link</span>
        </a>
    </li>
    <?php
} );
```

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

### Add Claim Listing Shortcode to Page

Source: https://docs.mylistingtheme.com/article/how-to-setup-claim-listing

Paste this shortcode into the content of your 'Claim listing' page. Ensure this page is not edited with Elementor.

```html
[claim_listing]
```

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

### Change Image Editor for Demo Import

Source: https://docs.mylistingtheme.com/article/demo-import-stuck

Add this filter to your child theme's functions.php to ensure the GD image editor is used, which can resolve attachment generation issues during demo import. Remember to remove it after the import is complete.

```php
add_filter( 'wp_image_editors', function() {
	return ['WP_Image_Editor_GD'];
} );
```

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

### Embed Video Field in Listing Page

Source: https://docs.mylistingtheme.com/article/upload-videos-to-your-listings

Use this HTML snippet within a Shortcode block on your single listing page to display the uploaded video. Ensure the '[[video-field]]' placeholder is replaced with the actual video field shortcode.

```html
<video width="100%" height="340" controls>
<source src="[[video-field]]" type="video/mp4">
</video>
```

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

### Make Website Link Clickable

Source: https://docs.mylistingtheme.com/article/make-website-email-phone-clickable

Use this HTML snippet to create a clickable link for a website field. Replace [[website]] with your custom link field key if needed. The target="_blank" attribute opens the link in a new tab.

```html
<a href="[[website]]" target="_blank">[[website]]</a>
```

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

### Filter for Listing Cover Image in Share Dialog

Source: https://docs.mylistingtheme.com/article/use-listing-cover-image-in-share-dialog-instead-of-the-logo-2

Use this filter to specify that the listing's cover image should be used in the share dialog. This code should be added to your theme's functions.php file.

```php
add_filter( 'mylisting\single\og:image', function() {
  return 'cover';
} );
```

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

### Bulk geolocate listings after importing (PHP)

Source: https://docs.mylistingtheme.com/explore?pg=3

This code snippet helps to geolocate listings in bulk after they have been imported. It's useful for ensuring all imported listings have accurate map data.

```php
<?php

/**
 * MyListing - Bulk geolocate listings after importing.
 *
 * @param array $args Query args.
 */
function mylisting_bulk_geolocate_listings( $args ) {
    if ( ! is_array( $args ) ) {
        return $args;
    }

    // Add a flag to indicate that geolocation should be performed.
    $args['geolocation_after_import'] = true;

    return $args;
}

add_filter( 'mylisting/query-args/listings', 'mylisting_bulk_geolocate_listings' );
```

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

### Enable Search by Listing ID

Source: https://docs.mylistingtheme.com/article/changelog

Add this filter hook in your child theme's functions.php to enable searching by listing ID for keyword searches.

```php
add_filter( 'mylisting/explore/keyword-search/include-listing-id' , '__return_true' );
```