File lib/fields/taxonomy.php

  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  84  85  86  87  88  89  90  91  92  93  94  95  96  97  98  99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144

<?php

/**
 * Delete property value in the database.
 *
 * @param  int    $term_id
 * @param  string $slug
 *
 * @return bool
 */
function papi_delete_term_field( $term_id, $slug = '' ) {
    if ( ! is_numeric( $term_id ) && is_string( $term_id ) ) {
        $slug    = $term_id;
        $term_id = null;
    }

    if ( ! is_string( $slug ) || empty( $slug ) ) {
        return false;
    }

    return papi_delete_field( papi_get_term_id( $term_id ), $slug, 'term' );
}

/**
 * Get property value from the database.
 *
 * @param  int    $term_id
 * @param  string $slug
 * @param  mixed  $default
 *
 * @return mixed
 */
function papi_get_term_field( $term_id = null, $slug = null, $default = null ) {
    if ( ! is_numeric( $term_id ) && is_string( $term_id ) ) {
        $default = $slug;
        $slug    = $term_id;
        $term_id = null;
    }

    if ( ! is_string( $slug ) || empty( $slug ) ) {
        return $default;
    }

    return papi_get_field( papi_get_term_id( $term_id ), $slug, $default, 'term' );
}

/**
 * Get boxes with properties slug for a taxonomy.
 *
 * @param  int    $id
 * @param  string $only_slugs
 *
 * @since 3.1.0 `$id` param is optional.
 *
 * @return array
 */
function papi_get_term_slugs( $id = 0, $only_slugs = false ) {
    if ( is_bool( $id ) ) {
        $only_slugs = $id;
        $id         = null;
    }

    return papi_get_slugs( papi_get_term_id( $id ), $only_slugs, 'term' );
}

/**
 * Shortcode for `papi_get_term_field` function.
 *
 * [papi_taxonomy id=1 slug="property_slug" default="Default value"][/papi_taxonomy]
 *
 * @param  array $atts
 *
 * @return mixed
 */
function papi_taxonomy_shortcode( $atts ) {
    $atts['id'] = isset( $atts['id'] ) ? $atts['id'] : 0;
    $atts['id'] = papi_get_term_id( $atts['id'] );
    $default    = isset( $atts['default'] ) ? $atts['default'] : '';

    if ( empty( $atts['id'] ) || empty( $atts['slug'] ) ) {
        $value = $default;
    } else {
        $value = papi_get_term_field( $atts['id'], $atts['slug'], $default );
    }

    if ( is_array( $value ) ) {
        $value = implode( ', ', $value );
    }

    return $value;
}

add_shortcode( 'papi_taxonomy', 'papi_taxonomy_shortcode' );

/**
 * Update property with new value. The old value will be deleted.
 *
 * @param  int    $term_id
 * @param  string $slug
 * @param  mixed  $value
 *
 * @return bool
 */
function papi_update_term_field( $term_id = null, $slug = null, $value = null ) {
    if ( ! is_numeric( $term_id ) && is_string( $term_id ) ) {
        $value   = $slug;
        $slug    = $term_id;
        $term_id = null;
    }

    if ( ! is_string( $slug ) || empty( $slug ) ) {
        return false;
    }

    if ( papi_is_empty( $value ) ) {
        return papi_delete_term_field( $term_id, $slug );
    }

    return papi_update_field( papi_get_term_id( $term_id ), $slug, $value, 'term' );
}

/**
 * Echo the value for property.
 *
 * @param int    $term_id
 * @param string $slug
 * @param mixed  $default
 */
function the_papi_term_field( $term_id = null, $slug = null, $default = null ) {
    $value = papi_get_term_field( $term_id, $slug, $default );

    if ( is_array( $value ) ) {
        $value = implode( ', ', $value );
    }

    if ( is_object( $value ) ) {
        // @codeCoverageIgnoreStart
        $value = print_r( $value, true );
        // @codeCoverageIgnoreEnd
    }

    echo $value;
}

Classes

Functions