Easy Property Listings 3.5.15 Code Reference
  • Package
  • Class
  • Tree
  • Todo
  • Hook Reference

Packages

  • EPL
    • Admin
      • Actions
      • Classes
        • ContactsTable
        • ReportsGraph
        • Welcome
      • Contacts
      • ContactsActions
      • ContactsFunctions
      • Elements
      • Functions
      • Help
      • HelpSingle
      • Menus
      • MenusAddons
      • MenusExtensions
      • MenusLicenses
      • Plugins
      • Reports
      • ReportsGraphing
      • User
    • Assets
      • ScriptsStyles
      • SVG
    • Classes
      • AuthorLoader
      • AuthorMeta
      • Contact
      • Cron
      • CustomPostType
      • Forms
      • License
      • ListingAdvanced
      • ListingElements
      • MetaboxesCustomFields
      • Pagination
      • PropertyMeta
      • RenderFields
      • RestAPI
      • Search
      • Session
      • Updater
    • Compatibility
      • Extensions
      • Functions
      • Shortcodes
    • Functions
      • Actions
      • ConditionalTags
      • ErrorTracking
      • Formatting
      • Front
      • Global
      • Install
      • Pagination
      • Settings
      • Templates
    • Hooks
      • EnergyCertificate
      • ExternalLinks
      • FloorPlan
      • Map
      • ReadMore
      • WebLink
    • Meta
      • InitCustomFields
      • Meta
    • PostTypes
      • Business
      • Commercial
      • CommercialLand
      • Contact
      • Functions
      • Land
      • Property
      • Rental
      • Rural
    • Shortcode
      • CommercialListingSearch
      • ContactForm
      • Listing
      • ListingAdvanced
      • ListingAuction
      • ListingCategory
      • ListingFeature
      • ListingLocation
      • ListingMetaDoc
      • ListingOpen
      • ListingResults
      • ListingSearch
      • Map
    • Taxonomy
      • BusinessCategories
      • ContactTag
      • Features
      • Location
    • Templates
      • Themes
        • iThemes
        • iThemesBuilder
    • Widget
      • Admin
        • Dashboard
      • Classes
        • Author
        • ContactCapture
        • Gallery
        • Listing
        • Search
      • Functions
  • None
  • WordPress
    • Session

Classes

  • EPL_Advanced_Shortcode_Listing
  • EPL_Author
  • EPL_Author_Loader
  • EPL_Author_Meta
  • EPL_Contact
  • EPL_Contact_Reports_Table
  • EPL_CPT
  • EPL_Cron
  • EPL_FORM_BUILDER
  • EPL_Graph
  • EPL_License
  • EPL_Listing_Elements
  • EPL_METABOX
  • EPL_Pagination_Call
  • EPL_Property_Meta
  • EPL_Render_Fields
  • EPL_Rest_API
  • EPL_SEARCH
  • EPL_Search_Fields
  • EPL_Session
  • EPL_SL_Plugin_Updater
  • EPL_Welcome
  • EPL_Widget_Author
  • EPL_Widget_Contact_Capture
  • EPL_Widget_Property_Gallery
  • EPL_Widget_Property_Search
  • EPL_Widget_Recent_Property

Functions

  • EPL
 1  2  3  4  5  6  7  8  9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 
<?php
/**
 * Outputs a property map onto the property template using a hook
 * This allows us to filter the hook and replace it with a different map
 *
 * @package     EPL
 * @subpackage  Hooks/Map
 * @copyright   Copyright (c) 2020, Merv Barrett
 * @license     http://opensource.org/licenses/gpl-2.0.php GNU Public License
 * @since       1.0.0
 */

// Exit if accessed directly.
if ( ! defined( 'ABSPATH' ) ) {
    exit;
}

/**
 * Pulls the address details so the map can be generated
 *
 * @param array $args Shortcode options.
 *
 * @since 1.0.0
 * @since 3.5.0 Tweak: [listing_map] Shortcode Added width, height and zoom options and allowed usage on any page. Filter: epl_map_display_defaults added.
 */
function epl_property_map_default_callback( $args ) {

    $defaults = array(
        'width'  => '100%',
        'height' => '350px',
        'zoom'   => '17',
    );

    $args = wp_parse_args( $args, apply_filters( 'epl_map_display_defaults', $defaults ) );

    global $property;

    $api_key      = epl_get_option( 'epl_google_api_key' );
    $show_warning = apply_filters( 'epl_show_map_key_warning', true );

    if ( empty( $api_key ) ) {
        if ( $show_warning && is_user_logged_in() && current_user_can( 'administrator' ) ) {
            epl_map_api_key_warning();
        }
        return;
    }

    // Only show map if address display is set to true.
    if ( 'yes' === $property->get_property_meta( 'property_address_display' ) ) {

        $address = epl_property_get_the_full_address();
        $address = apply_filters( 'epl_map_address', $address );

        // Use coordinates if they are already present.
        $coordinates = $property->get_property_meta( 'property_address_coordinates' );

        echo do_shortcode( '[listing_map zoom=14 width="' . $args['width'] . '" height="' . $args['height'] . '" zoom="' . $args['zoom'] . '" cord="' . $coordinates . '" q="' . $address . '"]' );
    } else {

        $address  = $property->get_property_meta( 'property_address_suburb' ) . ', ';
        $address .= $property->get_property_meta( 'property_address_state' ) . ', ';
        $address .= $property->get_property_meta( 'property_address_postal_code' );
        $address  = apply_filters( 'epl_map_address', $address );
        echo do_shortcode( '[listing_map zoom=14 suburb_mode=1 q="' . $address . '"]' );
    }
}
add_action( 'epl_property_map', 'epl_property_map_default_callback' );

/**
 * Missing map key warning message
 *
 * @since 3.3.0
 */
function epl_map_api_key_warning() { ?>

    <div class="epl-danger epl-warning-map-key">
        <p><?php esc_html_e( 'Ensure you have set a Google Maps API Key from Dashboard > Easy Property Listings > Settings.', 'easy-property-listings' ); ?>
            <em><?php esc_html_e( 'Note: This message is only displayed to logged in administrators.', 'easy-property-listings' ); ?></em>
        </p>
    </div>
    <?php
}
Easy Property Listings 3.5.15 Code Reference API documentation generated by ApiGen