wpdk-functions.php

Go to the documentation of this file.

<?php
// -----------------------------------------------------------------------------------------------------------------
// has/is zone
// -----------------------------------------------------------------------------------------------------------------

function wpdk_is_bool( $str )
{
  return !in_array( strtolower( $str ), array( '', 'false', '0', 'no', 'n', 'off', null ) );
}

function wpdk_is_url( $url )
{
  if ( !empty( $url ) && is_string( $url ) ) {
    return ( '#' === substr( $url, 0, 1 ) || '/' === substr( $url, 0, 1 ) || 'http' === substr( $url, 0, 4 ) ||
      false !== strpos( $url, '?' ) || false !== strpos( $url, '&' ) );
  }
  return false;
}

function wpdk_is_infinity( $value )
{
  _deprecated_function( __FUNCTION__, '1.2.0', 'WPDKMath::isInfinity()' );
  return WPDKMath::isInfinity( $value );
}

function wpdk_is_ajax()
{
  if ( defined( 'DOING_AJAX' ) ) {
    return true;
  }
  if ( isset( $_SERVER['HTTP_X_REQUESTED_WITH'] ) && strtolower( $_SERVER['HTTP_X_REQUESTED_WITH'] ) == 'xmlhttprequest'
  ) {
    return true;
  }
  else {
    return false;
  }
}


function wpdk_is_child( $parent = '' )
{
  global $post;

  $parent_obj   = get_post( $post->post_parent, ARRAY_A );
  $parent       = (string)$parent;
  $parent_array = (array)$parent;

  if ( $parent_obj && isset( $parent_obj['ID'] ) ) {
    if ( in_array( (string)$parent_obj['ID'], $parent_array ) ) {
      return true;
    }
    elseif ( in_array( (string)$parent_obj['post_title'], $parent_array ) ) {
      return true;
    }
    elseif ( in_array( (string)$parent_obj['post_name'], $parent_array ) ) {
      return true;
    }
    else {
      return false;
    }
  }
  return false;
}

// -----------------------------------------------------------------------------------------------------------------
// Sanitize
// -----------------------------------------------------------------------------------------------------------------

function wpdk_sanitize_function( $key )
{
  return str_replace( '-', '_', sanitize_key( $key ) );
}

function wpdk_get_image_size( $name )
{
  global $_wp_additional_image_sizes;
  if ( isset( $_wp_additional_image_sizes[$name] ) ) {
    return $_wp_additional_image_sizes[$name];
  }
  return false;
}

function wpdk_checked( $haystack, $current, $echo = true )
{
  if ( is_array( $haystack ) && in_array( $current, $haystack ) ) {
    $current = $haystack = 1;
  }
  return checked( $haystack, $current, $echo );
}

function wpdk_selected( $haystack, $current, $echo = true )
{
  _deprecated_function( __FUNCTION__, '1.2.0', 'WPDKHTMLTagSelect::selected()' );

  if ( is_array( $haystack ) && in_array( $current, $haystack ) ) {
    $current = $haystack = 1;
  }
  return selected( $haystack, $current, $echo );
}

/*
 * TODO Il recupero dell'id per la compatibilità WPML è del tutto simile a quello usato in wpdk_permalink_page_with_slug
 *       si potrebbe portare fuori visto che sarebbe anche il caso di creare una funzione generica al riguardo, tipo una:
 *       wpdk_page_with_slug() che restituisca appunto l'oggetto da cui recuperare tutto quello che serve.
 */

function wpdk_content_page_with_slug( $slug, $post_type, $alternative_slug = '' )
{
  global $wpdb;

  $page = get_page_by_path( $slug, OBJECT, $post_type );

  if ( is_null( $page ) ) {
    $page = get_page_by_path( $alternative_slug, OBJECT, $post_type );

    if ( is_null( $page ) ) {
      /* WPML? */
      if ( function_exists( 'icl_object_id' ) ) {
        $sql = <<< SQL
SELECT ID FROM {$wpdb->posts}
WHERE post_name = '{$slug}'
AND post_type = '{$post_type}'
AND post_status = 'publish'
SQL;
        $id  = $wpdb->get_var( $sql );
        $id  = icl_object_id( $id, $post_type, true );
      }
      else {
        return false;
      }
    }
    else {
      $id = $page->ID;
    }

    $page = get_post( $id );
  }

  return apply_filters( "the_content", $page->post_content );
}

function wpdk_permalink_page_with_slug( $slug, $post_type = 'page' )
{
  global $wpdb;

  /* Cerco la pagina. */
  $page = get_page_by_path( $slug, OBJECT, $post_type );

  /* Se non la trovo, prima di restituire null eseguo un controllo per WPML. */
  if ( is_null( $page ) ) {

    /* WPML? */
    if ( function_exists( 'icl_object_id' ) ) {
      $sql = <<< SQL
SELECT ID FROM {$wpdb->posts}
WHERE post_name = '{$slug}'
AND post_type = '{$post_type}'
AND post_status = 'publish'
SQL;
      $id  = $wpdb->get_var( $sql );
      $id  = icl_object_id( $id, $post_type, true );
    }
    else {
      return false;
    }
  }
  else {
    $id = $page->ID;
  }

  $permalink = get_permalink( $id );

  return trailingslashit( $permalink );
}

function wpdk_delta_object( $last_version, $old_version )
{
  _deprecated_function( __FUNCTION__, '1.2.0', 'WPDKObject::__delta()' );
  return WPDKObject::__delta( $last_version, $old_version );
}

function wpdk_get_image_in_post_content( $id_post )
{
  _deprecated_function( __FUNCTION__, '1.3.1', '_WPDKPost::imageContent() or _WPDKPost::imageContentWithID()' );

  ob_start();
  ob_end_clean();
  $output = preg_match_all( '/<img.+src=[\'"]([^\'"]+)[\'"].*>/i', get_post_field( 'post_content', $id_post ), $matches );
  if ( !empty( $matches ) && is_array( $matches ) && isset( $matches[1][0] ) ) {
    $display_img = $matches[1][0];
    return $display_img;
  }
  return null;
}

function wpdk_get_image_from_post_thumbnail( $id_post )
{
  _deprecated_function( __FUNCTION__, '1.3.1', '_WPDKPost::thumbnail() or _WPDKPost::thumbnailWithID()' );
  if ( function_exists( 'has_post_thumbnail' ) ) {
    if ( has_post_thumbnail( $id_post ) ) {
      $image = wp_get_attachment_image_src( get_post_thumbnail_id( $id_post ), 'full' );
      return $image[0];
    }
  }
  return null;
}

function wpdk_get_image_from_attachments( $id_post )
{
  _deprecated_function( __FUNCTION__, '1.3.1', '_WPDKPost::imageAttachmentsWithID() or _WPDKPost::imageAttachments()' );
  if ( function_exists( 'wp_get_attachment_image' ) ) {
    $children = get_children( array(
                                   'post_parent'    => $id_post,
                                   'post_type'      => 'attachment',
                                   'numberposts'    => 1,
                                   'post_status'    => 'inherit',
                                   'post_mime_type' => 'image',
                                   'order'          => 'ASC',
                                   'orderby'        => 'menu_order ASC'
                              ) );

    if ( empty( $children ) || !is_array( $children ) ) {
      return false;
    }

    $item = current( $children );

    if ( is_object( $item ) && isset( $item->ID ) ) {
      $image = wp_get_attachment_image_src( $item->ID, 'full' );
      return $image[0];
    }
  }
  return false;
}

// -----------------------------------------------------------------------------------------------------------------
// WPDKResult check
// -----------------------------------------------------------------------------------------------------------------

function is_wpdk_error( $thing )
{
  _deprecated_function( __FUNCTION__, '1.2.0', 'WPDKResult::isError()' );
  return WPDKResult::isError( $thing );
}

function is_wpdk_warning( $thing )
{
  _deprecated_function( __FUNCTION__, '1.2.0', 'WPDKResult::isWarning()' );
  return WPDKResult::isWarning( $thing );
}

function is_wpdk_status( $thing )
{
  _deprecated_function( __FUNCTION__, '1.2.0', 'WPDKResult::isStatus()' );
  return WPDKResult::isWarning( $thing );
}

// -----------------------------------------------------------------------------------------------------------------
// WPDKResult check
// -----------------------------------------------------------------------------------------------------------------

function wpdk_add_page( $page_slug, $page_title, $capability, $function = '', $hook_head = '', $hook_load = '' )
{
  global $admin_page_hooks, $_registered_pages, $_parent_pages;

  $hookname = '';

  if ( !empty( $function ) && current_user_can( $capability ) ) {
    $page_slug                    = plugin_basename( $page_slug );
    $admin_page_hooks[$page_slug] = $page_title;
    $hookname                     = get_plugin_page_hookname( $page_slug, '' );
    if ( !empty( $hookname ) ) {
      add_action( $hookname, $function );
      $_registered_pages[$hookname] = true;
      $_parent_pages[$page_slug]    = false;

      if ( !empty( $hook_head ) ) {
        add_action( 'admin_head-' . $hookname, $hook_head );
      }

      if ( !empty( $hook_load ) ) {
        add_action( 'load-' . $hookname, $hook_load );
      }
    }
  }
  return $hookname;
}

function wpdk_enqueue_script_page( $pages, $handle, $src = false, $deps = array(), $ver = false, $in_footer = false )
{
  foreach ( $pages as $slug ) {
    if ( is_page_template( $slug ) ) {
      wp_enqueue_script( $handle, $src, $deps, $ver, $in_footer );
      break;
    }
  }
}

function wpdk_enqueue_script_page_template( $page_templates, $handle, $src = false, $deps = array(), $ver = false, $in_footer = false )
{
  if ( empty( $page_templates ) ) {
    return false;
  }
  if ( is_string( $page_templates ) ) {
    $page_templates = array( $page_templates );
  }
  foreach ( $page_templates as $slug ) {
    if ( is_page_template( $slug ) ) {
      wp_enqueue_script( $handle, $src, $deps, $ver, $in_footer );
      break;
    }
  }
  return true;
}

function wpdk_set_user_transient( $transient, $value, $expiration = 0, $user_id = null )
{
  _deprecated_function( __CLASS__ . '::' . __FUNCTION__, '1.3.0', 'WPDKUser::setTransientWithUser()' );
  return WPDKUser::setTransientWithUser( $transient, $value, $expiration, $user_id );
}

function wpdk_get_user_transient( $transient, $user_id = null )
{
  _deprecated_function( __CLASS__ . '::' . __FUNCTION__, '1.4.8', 'WPDKUser::getTransientWithUser()' );
  return WPDKUser::getTransientWithUser( $transient, $user_id );
}

function wpdk_delete_user_transient( $transient, $user_id = null )
{

  $user_id = is_null( $user_id ) ? get_current_user_id() : $user_id;

  do_action( 'delete_user_transient_' . $transient, $transient, $user_id );

  $transient_timeout = '_transient_timeout_' . $transient;
  $transient         = '_transient_' . $transient;
  $result            = delete_user_meta( $user_id, $transient );
  if ( $result ) {
    delete_user_meta( $user_id, $transient_timeout );
    do_action( 'deleted_user_transient', $transient, $user_id );
  }

  return $result;
}

function wpdk_is_request( $verb )
{
  $verb = strtolower( $verb );
  return ( $verb == strtolower( $_SERVER['REQUEST_METHOD'] ) );
}

function wpdk_is_request_get()
{
  return wpdk_is_request( 'get' );
}

function wpdk_is_request_post()
{
  return wpdk_is_request( 'post' );
}