jarednova / timber

lib/timber-helper.php

Indentation +647 added lines, -647 removed lines

@@ -5,664 +5,664 @@
  */
 class TimberHelper {
 
-	/**
-	 * A utility for a one-stop shop for Transients
-	 * @api
-	 * @example
-	 * ```php
-	 * $favorites = Timber::transient('user-'.$uid.'-favorites', function() use ($uid) {
-	 *  	//some expensive query here that's doing something you want to store to a transient
-	 *  	return $favorites;
-	 * }, 600);
-	 * Timber::context['favorites'] = $favorites;
-	 * Timber::render('single.twig', $context);
-	 * ```
-	 *
-	 * @param string  $slug           Unique identifier for transient
-	 * @param callable $callback      Callback that generates the data that's to be cached
-	 * @param int     $transient_time (optional) Expiration of transients in seconds
-	 * @param int     $lock_timeout   (optional) How long (in seconds) to lock the transient to prevent race conditions
-	 * @param bool    $force          (optional) Force callback to be executed when transient is locked
-	 * @return mixed
-	 */
-	public static function transient( $slug, $callback, $transient_time = 0, $lock_timeout = 5, $force = false ) {
-		$slug = apply_filters( 'timber/transient/slug', $slug );
-
-		$enable_transients = ( $transient_time === false || ( defined( 'WP_DISABLE_TRANSIENTS' ) && WP_DISABLE_TRANSIENTS ) ) ? false : true;
-		$data = $enable_transients ? get_transient( $slug ) : false;
-
-		if ( false === $data ) {
-
-			if ( $enable_transients && self::_is_transient_locked( $slug ) ) {
-
-				$force = apply_filters( 'timber_force_transients', $force );
-				$force = apply_filters( 'timber_force_transient_' . $slug, $force );
-
-				if ( !$force ) {
-					//the server is currently executing the process.
-					//We're just gonna dump these users. Sorry!
-					return false;
-				}
-
-				$enable_transients = false;
-			}
-
-			// lock timeout shouldn't be higher than 5 seconds, unless
-			// remote calls with high timeouts are made here
-			if ( $enable_transients )
-				self::_lock_transient( $slug, $lock_timeout );
-
-			$data = $callback();
-
-			if ( $enable_transients ) {
-				set_transient( $slug, $data, $transient_time );
-				self::_unlock_transient( $slug );
-			}
-
-		}
-
-		return $data;
-
-	}
-
-	/**
-	 * @internal
-	 * @param string $slug
-	 * @param integer $lock_timeout
-	 */
-	static function _lock_transient( $slug, $lock_timeout ) {
-		set_transient( $slug . '_lock', true, $lock_timeout );
-	}
-
-	/**
-	 * @internal
-	 * @param string $slug
-	 */
-	static function _unlock_transient( $slug ) {
-		delete_transient( $slug . '_lock', true );
-	}
-
-	/**
-	 * @internal
-	 * @param string $slug
-	 */
-	static function _is_transient_locked( $slug ) {
-		return (bool)get_transient( $slug . '_lock' );
-	}
-
-	/* These are for measuring page render time */
-
-	/**
-	 * For measuring time, this will start a timer
-	 * @api
-	 * @return float
-	 */
-	public static function start_timer() {
-		$time = microtime();
-		$time = explode( ' ', $time );
-		$time = $time[1] + $time[0];
-		return $time;
-	}
-
-	/**
-	 * For stopping time and getting the data
-	 * @example
-	 * ```php
-	 * $start = TimberHelper::start_timer();
-	 * // do some stuff that takes awhile
-	 * echo TimberHelper::stop_timer( $start );
-	 * ```
-	 * @param int     $start
-	 * @return string
-	 */
-	public static function stop_timer( $start ) {
-		$time = microtime();
-		$time = explode( ' ', $time );
-		$time = $time[1] + $time[0];
-		$finish = $time;
-		$total_time = round( ( $finish - $start ), 4 );
-		return $total_time . ' seconds.';
-	}
-
-	/* Function Utilities
+    /**
+     * A utility for a one-stop shop for Transients
+     * @api
+     * @example
+     * ```php
+     * $favorites = Timber::transient('user-'.$uid.'-favorites', function() use ($uid) {
+     *  	//some expensive query here that's doing something you want to store to a transient
+     *  	return $favorites;
+     * }, 600);
+     * Timber::context['favorites'] = $favorites;
+     * Timber::render('single.twig', $context);
+     * ```
+     *
+     * @param string  $slug           Unique identifier for transient
+     * @param callable $callback      Callback that generates the data that's to be cached
+     * @param int     $transient_time (optional) Expiration of transients in seconds
+     * @param int     $lock_timeout   (optional) How long (in seconds) to lock the transient to prevent race conditions
+     * @param bool    $force          (optional) Force callback to be executed when transient is locked
+     * @return mixed
+     */
+    public static function transient( $slug, $callback, $transient_time = 0, $lock_timeout = 5, $force = false ) {
+        $slug = apply_filters( 'timber/transient/slug', $slug );
+
+        $enable_transients = ( $transient_time === false || ( defined( 'WP_DISABLE_TRANSIENTS' ) && WP_DISABLE_TRANSIENTS ) ) ? false : true;
+        $data = $enable_transients ? get_transient( $slug ) : false;
+
+        if ( false === $data ) {
+
+            if ( $enable_transients && self::_is_transient_locked( $slug ) ) {
+
+                $force = apply_filters( 'timber_force_transients', $force );
+                $force = apply_filters( 'timber_force_transient_' . $slug, $force );
+
+                if ( !$force ) {
+                    //the server is currently executing the process.
+                    //We're just gonna dump these users. Sorry!
+                    return false;
+                }
+
+                $enable_transients = false;
+            }
+
+            // lock timeout shouldn't be higher than 5 seconds, unless
+            // remote calls with high timeouts are made here
+            if ( $enable_transients )
+                self::_lock_transient( $slug, $lock_timeout );
+
+            $data = $callback();
+
+            if ( $enable_transients ) {
+                set_transient( $slug, $data, $transient_time );
+                self::_unlock_transient( $slug );
+            }
+
+        }
+
+        return $data;
+
+    }
+
+    /**
+     * @internal
+     * @param string $slug
+     * @param integer $lock_timeout
+     */
+    static function _lock_transient( $slug, $lock_timeout ) {
+        set_transient( $slug . '_lock', true, $lock_timeout );
+    }
+
+    /**
+     * @internal
+     * @param string $slug
+     */
+    static function _unlock_transient( $slug ) {
+        delete_transient( $slug . '_lock', true );
+    }
+
+    /**
+     * @internal
+     * @param string $slug
+     */
+    static function _is_transient_locked( $slug ) {
+        return (bool)get_transient( $slug . '_lock' );
+    }
+
+    /* These are for measuring page render time */
+
+    /**
+     * For measuring time, this will start a timer
+     * @api
+     * @return float
+     */
+    public static function start_timer() {
+        $time = microtime();
+        $time = explode( ' ', $time );
+        $time = $time[1] + $time[0];
+        return $time;
+    }
+
+    /**
+     * For stopping time and getting the data
+     * @example
+     * ```php
+     * $start = TimberHelper::start_timer();
+     * // do some stuff that takes awhile
+     * echo TimberHelper::stop_timer( $start );
+     * ```
+     * @param int     $start
+     * @return string
+     */
+    public static function stop_timer( $start ) {
+        $time = microtime();
+        $time = explode( ' ', $time );
+        $time = $time[1] + $time[0];
+        $finish = $time;
+        $total_time = round( ( $finish - $start ), 4 );
+        return $total_time . ' seconds.';
+    }
+
+    /* Function Utilities
 	======================== */
 
-	/**
-	 * Calls a function with an output buffer. This is useful if you have a function that outputs text that you want to capture and use within a twig template.
-	 * @example
-	 * ```php
-	 * function the_form() {
-	 *     echo '<form action="form.php"><input type="text" /><input type="submit /></form>';
-	 * }
-	 *
-	 * $context = Timber::get_context();
-	 * $context['post'] = new TimberPost();
-	 * $context['my_form'] = TimberHelper::ob_function('the_form');
-	 * Timber::render('single-form.twig', $context);
-	 * ```
-	 * ```twig
-	 * <h1>{{ post.title }}</h1>
-	 * {{ my_form }}
-	 * ```
-	 * ```html
-	 * <h1>Apply to my contest!</h1>
-	 * <form action="form.php"><input type="text" /><input type="submit /></form>
-	 * ```
-	 * @api
-	 * @param callback $function
-	 * @param array   $args
-	 * @return string
-	 */
-	public static function ob_function( $function, $args = array( null ) ) {
-		ob_start();
-		call_user_func_array( $function, $args );
-		$data = ob_get_contents();
-		ob_end_clean();
-		return $data;
-	}
-
-	/**
-	 *
-	 *
-	 * @param string  $function_name
-	 * @param integer[]   $defaults
-	 * @param bool    $return_output_buffer
-	 * @return TimberFunctionWrapper
-	 */
-	public static function function_wrapper( $function_name, $defaults = array(), $return_output_buffer = false ) {
-		return new TimberFunctionWrapper( $function_name, $defaults, $return_output_buffer );
-	}
-
-	/**
-	 *
-	 *
-	 * @param mixed $arg that you want to error_log
-	 * @return void
-	 */
-	public static function error_log( $arg ) {
-		if ( !WP_DEBUG ) {
-			return;
-		}
-		if ( is_object( $arg ) || is_array( $arg ) ) {
-			$arg = print_r( $arg, true );
-		}
-		return error_log( $arg );
-	}
-
-	/**
-	 *
-	 *
-	 * @param string  $separator
-	 * @param string  $seplocation
-	 * @return string
-	 */
-	public static function get_wp_title( $separator = ' ', $seplocation = 'left' ) {
-		$separator = apply_filters( 'timber_wp_title_seperator', $separator );
-		return trim( wp_title( $separator, false, $seplocation ) );
-	}
-
-	/* Text Utilities
+    /**
+     * Calls a function with an output buffer. This is useful if you have a function that outputs text that you want to capture and use within a twig template.
+     * @example
+     * ```php
+     * function the_form() {
+     *     echo '<form action="form.php"><input type="text" /><input type="submit /></form>';
+     * }
+     *
+     * $context = Timber::get_context();
+     * $context['post'] = new TimberPost();
+     * $context['my_form'] = TimberHelper::ob_function('the_form');
+     * Timber::render('single-form.twig', $context);
+     * ```
+     * ```twig
+     * <h1>{{ post.title }}</h1>
+     * {{ my_form }}
+     * ```
+     * ```html
+     * <h1>Apply to my contest!</h1>
+     * <form action="form.php"><input type="text" /><input type="submit /></form>
+     * ```
+     * @api
+     * @param callback $function
+     * @param array   $args
+     * @return string
+     */
+    public static function ob_function( $function, $args = array( null ) ) {
+        ob_start();
+        call_user_func_array( $function, $args );
+        $data = ob_get_contents();
+        ob_end_clean();
+        return $data;
+    }
+
+    /**
+     *
+     *
+     * @param string  $function_name
+     * @param integer[]   $defaults
+     * @param bool    $return_output_buffer
+     * @return TimberFunctionWrapper
+     */
+    public static function function_wrapper( $function_name, $defaults = array(), $return_output_buffer = false ) {
+        return new TimberFunctionWrapper( $function_name, $defaults, $return_output_buffer );
+    }
+
+    /**
+     *
+     *
+     * @param mixed $arg that you want to error_log
+     * @return void
+     */
+    public static function error_log( $arg ) {
+        if ( !WP_DEBUG ) {
+            return;
+        }
+        if ( is_object( $arg ) || is_array( $arg ) ) {
+            $arg = print_r( $arg, true );
+        }
+        return error_log( $arg );
+    }
+
+    /**
+     *
+     *
+     * @param string  $separator
+     * @param string  $seplocation
+     * @return string
+     */
+    public static function get_wp_title( $separator = ' ', $seplocation = 'left' ) {
+        $separator = apply_filters( 'timber_wp_title_seperator', $separator );
+        return trim( wp_title( $separator, false, $seplocation ) );
+    }
+
+    /* Text Utilities
 	======================== */
 
-	/**
-	 *
-	 *
-	 * @param string  $text
-	 * @param int     $num_words
-	 * @param string|null|false  $more text to appear in "Read more...". Null to use default, false to hide
-	 * @param string  $allowed_tags
-	 * @return string
-	 */
-	public static function trim_words( $text, $num_words = 55, $more = null, $allowed_tags = 'p a span b i br blockquote' ) {
-		if ( null === $more ) {
-			$more = __( '&hellip;' );
-		}
-		$original_text = $text;
-		$allowed_tag_string = '';
-		foreach ( explode( ' ', apply_filters( 'timber/trim_words/allowed_tags', $allowed_tags ) ) as $tag ) {
-			$allowed_tag_string .= '<' . $tag . '>';
-		}
-		$text = strip_tags( $text, $allowed_tag_string );
-		/* translators: If your word count is based on single characters (East Asian characters), enter 'characters'. Otherwise, enter 'words'. Do not translate into your own language. */
-		if ( 'characters' == _x( 'words', 'word count: words or characters?' ) && preg_match( '/^utf\-?8$/i', get_option( 'blog_charset' ) ) ) {
-			$text = trim( preg_replace( "/[\n\r\t ]+/", ' ', $text ), ' ' );
-			preg_match_all( '/./u', $text, $words_array );
-			$words_array = array_slice( $words_array[0], 0, $num_words + 1 );
-			$sep = '';
-		} else {
-			$words_array = preg_split( "/[\n\r\t ]+/", $text, $num_words + 1, PREG_SPLIT_NO_EMPTY );
-			$sep = ' ';
-		}
-		if ( count( $words_array ) > $num_words ) {
-			array_pop( $words_array );
-			$text = implode( $sep, $words_array );
-			$text = $text . $more;
-		} else {
-			$text = implode( $sep, $words_array );
-		}
-		$text = self::close_tags( $text );
-		return apply_filters( 'wp_trim_words', $text, $num_words, $more, $original_text );
-	}
-
-	/**
-	 *
-	 *
-	 * @param string  $html
-	 * @return string
-	 */
-	public static function close_tags( $html ) {
-		//put all opened tags into an array
-		preg_match_all( '#<([a-z]+)(?: .*)?(?<![/|/ ])>#iU', $html, $result );
-		$openedtags = $result[1];
-		//put all closed tags into an array
-		preg_match_all( '#</([a-z]+)>#iU', $html, $result );
-		$closedtags = $result[1];
-		$len_opened = count( $openedtags );
-		// all tags are closed
-		if ( count( $closedtags ) == $len_opened ) {
-			return $html;
-		}
-		$openedtags = array_reverse( $openedtags );
-		// close tags
-		for ( $i = 0; $i < $len_opened; $i++ ) {
-			if ( !in_array( $openedtags[$i], $closedtags ) ) {
-				$html .= '</' . $openedtags[$i] . '>';
-			} else {
-				unset( $closedtags[array_search( $openedtags[$i], $closedtags )] );
-			}
-		}
-		$html = str_replace(array('</br>','</hr>','</wbr>'), '', $html);
-		$html = str_replace(array('<br>','<hr>','<wbr>'), array('<br />','<hr />','<wbr />'), $html);
-		return $html;
-	}
-
-	/* WordPress Query Utilities
+    /**
+     *
+     *
+     * @param string  $text
+     * @param int     $num_words
+     * @param string|null|false  $more text to appear in "Read more...". Null to use default, false to hide
+     * @param string  $allowed_tags
+     * @return string
+     */
+    public static function trim_words( $text, $num_words = 55, $more = null, $allowed_tags = 'p a span b i br blockquote' ) {
+        if ( null === $more ) {
+            $more = __( '&hellip;' );
+        }
+        $original_text = $text;
+        $allowed_tag_string = '';
+        foreach ( explode( ' ', apply_filters( 'timber/trim_words/allowed_tags', $allowed_tags ) ) as $tag ) {
+            $allowed_tag_string .= '<' . $tag . '>';
+        }
+        $text = strip_tags( $text, $allowed_tag_string );
+        /* translators: If your word count is based on single characters (East Asian characters), enter 'characters'. Otherwise, enter 'words'. Do not translate into your own language. */
+        if ( 'characters' == _x( 'words', 'word count: words or characters?' ) && preg_match( '/^utf\-?8$/i', get_option( 'blog_charset' ) ) ) {
+            $text = trim( preg_replace( "/[\n\r\t ]+/", ' ', $text ), ' ' );
+            preg_match_all( '/./u', $text, $words_array );
+            $words_array = array_slice( $words_array[0], 0, $num_words + 1 );
+            $sep = '';
+        } else {
+            $words_array = preg_split( "/[\n\r\t ]+/", $text, $num_words + 1, PREG_SPLIT_NO_EMPTY );
+            $sep = ' ';
+        }
+        if ( count( $words_array ) > $num_words ) {
+            array_pop( $words_array );
+            $text = implode( $sep, $words_array );
+            $text = $text . $more;
+        } else {
+            $text = implode( $sep, $words_array );
+        }
+        $text = self::close_tags( $text );
+        return apply_filters( 'wp_trim_words', $text, $num_words, $more, $original_text );
+    }
+
+    /**
+     *
+     *
+     * @param string  $html
+     * @return string
+     */
+    public static function close_tags( $html ) {
+        //put all opened tags into an array
+        preg_match_all( '#<([a-z]+)(?: .*)?(?<![/|/ ])>#iU', $html, $result );
+        $openedtags = $result[1];
+        //put all closed tags into an array
+        preg_match_all( '#</([a-z]+)>#iU', $html, $result );
+        $closedtags = $result[1];
+        $len_opened = count( $openedtags );
+        // all tags are closed
+        if ( count( $closedtags ) == $len_opened ) {
+            return $html;
+        }
+        $openedtags = array_reverse( $openedtags );
+        // close tags
+        for ( $i = 0; $i < $len_opened; $i++ ) {
+            if ( !in_array( $openedtags[$i], $closedtags ) ) {
+                $html .= '</' . $openedtags[$i] . '>';
+            } else {
+                unset( $closedtags[array_search( $openedtags[$i], $closedtags )] );
+            }
+        }
+        $html = str_replace(array('</br>','</hr>','</wbr>'), '', $html);
+        $html = str_replace(array('<br>','<hr>','<wbr>'), array('<br />','<hr />','<wbr />'), $html);
+        return $html;
+    }
+
+    /* WordPress Query Utilities
 	======================== */
 
-	/**
-	 * @param string  $key
-	 * @param string  $value
-	 * @return array|int
-	 * @deprecated 0.20.0
-	 */
-	public static function get_posts_by_meta( $key, $value ) {
-		global $wpdb;
-		$query = $wpdb->prepare( "SELECT post_id FROM $wpdb->postmeta WHERE meta_key = %s AND meta_value = %s", $key, $value );
-		$results = $wpdb->get_col( $query );
-		$pids = array();
-		foreach ( $results as $result ) {
-			if ( get_post( $result ) ) {
-				$pids[] = $result;
-			}
-		}
-		if ( count( $pids ) ) {
-			return $pids;
-		}
-		return 0;
-	}
-
-	/**
-	 *
-	 *
-	 * @param string  $key
-	 * @param string  $value
-	 * @return int
-	 * @deprecated 0.20.0
-	 */
-	public static function get_post_by_meta( $key, $value ) {
-		global $wpdb;
-		$query = $wpdb->prepare( "SELECT post_id FROM $wpdb->postmeta WHERE meta_key = %s AND meta_value = %s ORDER BY post_id", $key, $value );
-		$results = $wpdb->get_col( $query );
-		foreach ( $results as $result ) {
-			if ( $result && get_post( $result ) ) {
-				return $result;
-			}
-		}
-		return 0;
-	}
-
-	/**
-	 *
-	 * @deprecated 0.21.8
-	 * @param int     $ttid
-	 * @return mixed
-	 */
-	public static function get_term_id_by_term_taxonomy_id( $ttid ) {
-		global $wpdb;
-		$query = $wpdb->prepare( "SELECT term_id FROM $wpdb->term_taxonomy WHERE term_taxonomy_id = %s", $ttid );
-		return $wpdb->get_var( $query );
-	}
-
-	/* Object Utilities
+    /**
+     * @param string  $key
+     * @param string  $value
+     * @return array|int
+     * @deprecated 0.20.0
+     */
+    public static function get_posts_by_meta( $key, $value ) {
+        global $wpdb;
+        $query = $wpdb->prepare( "SELECT post_id FROM $wpdb->postmeta WHERE meta_key = %s AND meta_value = %s", $key, $value );
+        $results = $wpdb->get_col( $query );
+        $pids = array();
+        foreach ( $results as $result ) {
+            if ( get_post( $result ) ) {
+                $pids[] = $result;
+            }
+        }
+        if ( count( $pids ) ) {
+            return $pids;
+        }
+        return 0;
+    }
+
+    /**
+     *
+     *
+     * @param string  $key
+     * @param string  $value
+     * @return int
+     * @deprecated 0.20.0
+     */
+    public static function get_post_by_meta( $key, $value ) {
+        global $wpdb;
+        $query = $wpdb->prepare( "SELECT post_id FROM $wpdb->postmeta WHERE meta_key = %s AND meta_value = %s ORDER BY post_id", $key, $value );
+        $results = $wpdb->get_col( $query );
+        foreach ( $results as $result ) {
+            if ( $result && get_post( $result ) ) {
+                return $result;
+            }
+        }
+        return 0;
+    }
+
+    /**
+     *
+     * @deprecated 0.21.8
+     * @param int     $ttid
+     * @return mixed
+     */
+    public static function get_term_id_by_term_taxonomy_id( $ttid ) {
+        global $wpdb;
+        $query = $wpdb->prepare( "SELECT term_id FROM $wpdb->term_taxonomy WHERE term_taxonomy_id = %s", $ttid );
+        return $wpdb->get_var( $query );
+    }
+
+    /* Object Utilities
 	======================== */
 
-	/**
-	 *
-	 *
-	 * @param array   $array
-	 * @param string  $prop
-	 * @return void
-	 */
-	public static function osort( &$array, $prop ) {
-		usort( $array, function ( $a, $b ) use ( $prop ) {
-				return $a->$prop > $b->$prop ? 1 : -1;
-			} );
-	}
-
-	/**
-	 *
-	 *
-	 * @param array   $arr
-	 * @return bool
-	 */
-	public static function is_array_assoc( $arr ) {
-		if ( !is_array( $arr ) ) {
-			return false;
-		}
-		return (bool)count( array_filter( array_keys( $arr ), 'is_string' ) );
-	}
-
-	/**
-	 *
-	 *
-	 * @param array   $array
-	 * @return stdClass
-	 */
-	public static function array_to_object( $array ) {
-		$obj = new stdClass;
-		foreach ( $array as $k => $v ) {
-			if ( is_array( $v ) ) {
-				$obj->{$k} = self::array_to_object( $v ); //RECURSION
-			} else {
-				$obj->{$k} = $v;
-			}
-		}
-		return $obj;
-	}
-
-	/**
-	 *
-	 *
-	 * @param array   $array
-	 * @param string  $key
-	 * @param mixed   $value
-	 * @return bool|int
-	 */
-	public static function get_object_index_by_property( $array, $key, $value ) {
-		if ( is_array( $array ) ) {
-			$i = 0;
-			foreach ( $array as $arr ) {
-				if ( is_array( $arr ) ) {
-					if ( $arr[$key] == $value ) {
-						return $i;
-					}
-				} else {
-					if ( $arr->$key == $value ) {
-						return $i;
-					}
-				}
-				$i++;
-			}
-		}
-		return false;
-	}
-
-	/**
-	 *
-	 *
-	 * @param array   $array
-	 * @param string  $key
-	 * @param mixed   $value
-	 * @return array|null
-	 * @throws Exception
-	 */
-	public static function get_object_by_property( $array, $key, $value ) {
-		if ( is_array( $array ) ) {
-			foreach ( $array as $arr ) {
-				if ( $arr->$key == $value ) {
-					return $arr;
-				}
-			}
-		} else {
-			throw new InvalidArgumentException( '$array is not an array, got:' );
-			TimberHelper::error_log( $array );
-		}
-	}
-
-	/**
-	 *
-	 *
-	 * @param array   $array
-	 * @param int     $len
-	 * @return array
-	 */
-	public static function array_truncate( $array, $len ) {
-		if ( sizeof( $array ) > $len ) {
-			$array = array_splice( $array, 0, $len );
-		}
-		return $array;
-	}
-
-	/* Bool Utilities
+    /**
+     *
+     *
+     * @param array   $array
+     * @param string  $prop
+     * @return void
+     */
+    public static function osort( &$array, $prop ) {
+        usort( $array, function ( $a, $b ) use ( $prop ) {
+                return $a->$prop > $b->$prop ? 1 : -1;
+            } );
+    }
+
+    /**
+     *
+     *
+     * @param array   $arr
+     * @return bool
+     */
+    public static function is_array_assoc( $arr ) {
+        if ( !is_array( $arr ) ) {
+            return false;
+        }
+        return (bool)count( array_filter( array_keys( $arr ), 'is_string' ) );
+    }
+
+    /**
+     *
+     *
+     * @param array   $array
+     * @return stdClass
+     */
+    public static function array_to_object( $array ) {
+        $obj = new stdClass;
+        foreach ( $array as $k => $v ) {
+            if ( is_array( $v ) ) {
+                $obj->{$k} = self::array_to_object( $v ); //RECURSION
+            } else {
+                $obj->{$k} = $v;
+            }
+        }
+        return $obj;
+    }
+
+    /**
+     *
+     *
+     * @param array   $array
+     * @param string  $key
+     * @param mixed   $value
+     * @return bool|int
+     */
+    public static function get_object_index_by_property( $array, $key, $value ) {
+        if ( is_array( $array ) ) {
+            $i = 0;
+            foreach ( $array as $arr ) {
+                if ( is_array( $arr ) ) {
+                    if ( $arr[$key] == $value ) {
+                        return $i;
+                    }
+                } else {
+                    if ( $arr->$key == $value ) {
+                        return $i;
+                    }
+                }
+                $i++;
+            }
+        }
+        return false;
+    }
+
+    /**
+     *
+     *
+     * @param array   $array
+     * @param string  $key
+     * @param mixed   $value
+     * @return array|null
+     * @throws Exception
+     */
+    public static function get_object_by_property( $array, $key, $value ) {
+        if ( is_array( $array ) ) {
+            foreach ( $array as $arr ) {
+                if ( $arr->$key == $value ) {
+                    return $arr;
+                }
+            }
+        } else {
+            throw new InvalidArgumentException( '$array is not an array, got:' );
+            TimberHelper::error_log( $array );
+        }
+    }
+
+    /**
+     *
+     *
+     * @param array   $array
+     * @param int     $len
+     * @return array
+     */
+    public static function array_truncate( $array, $len ) {
+        if ( sizeof( $array ) > $len ) {
+            $array = array_splice( $array, 0, $len );
+        }
+        return $array;
+    }
+
+    /* Bool Utilities
 	======================== */
 
-	/**
-	 *
-	 *
-	 * @param mixed   $value
-	 * @return bool
-	 */
-	public static function is_true( $value ) {
-		if ( isset( $value ) ) {
-			if (is_string($value)) {
-				$value = strtolower($value);
-			}
-			if ( ($value == 'true' || $value === 1 || $value === '1' || $value == true) && $value !== false && $value !== 'false') {
-				return true;
-			}
-		}
-		return false;
-	}
-
-	/**
-	 *
-	 *
-	 * @param int     $i
-	 * @return bool
-	 */
-	public static function iseven( $i ) {
-		return ( $i % 2 ) == 0;
-	}
-
-	/**
-	 *
-	 *
-	 * @param int     $i
-	 * @return bool
-	 */
-	public static function isodd( $i ) {
-		return ( $i % 2 ) != 0;
-	}
-
-	/* Links, Forms, Etc. Utilities
+    /**
+     *
+     *
+     * @param mixed   $value
+     * @return bool
+     */
+    public static function is_true( $value ) {
+        if ( isset( $value ) ) {
+            if (is_string($value)) {
+                $value = strtolower($value);
+            }
+            if ( ($value == 'true' || $value === 1 || $value === '1' || $value == true) && $value !== false && $value !== 'false') {
+                return true;
+            }
+        }
+        return false;
+    }
+
+    /**
+     *
+     *
+     * @param int     $i
+     * @return bool
+     */
+    public static function iseven( $i ) {
+        return ( $i % 2 ) == 0;
+    }
+
+    /**
+     *
+     *
+     * @param int     $i
+     * @return bool
+     */
+    public static function isodd( $i ) {
+        return ( $i % 2 ) != 0;
+    }
+
+    /* Links, Forms, Etc. Utilities
 	======================== */
 
-	/**
-	 *
-	 * Gets the comment form for use on a single article page
-	 * @deprecated 0.21.8 use `{{ function('comment_form') }}` instead
-	 * @param int     $post_id which post_id should the form be tied to?
-	 * @param array   $args this $args thing is a fucking mess, [fix at some point](http://codex.wordpress.org/Function_Reference/comment_form)
-	 * @return string
-	 */
-	public static function get_comment_form( $post_id = null, $args = array() ) {
-		return self::ob_function( 'comment_form', array( $args, $post_id ) );
-	}
-
-	/**
-	 *
-	 *
-	 * @param string  $args
-	 * @return array
-	 */
-	public static function paginate_links( $args = '' ) {
-		$defaults = array(
-			'base' => '%_%', // http://example.com/all_posts.php%_% : %_% is replaced by format (below)
-			'format' => '?page=%#%', // ?page=%#% : %#% is replaced by the page number
-			'total' => 1,
-			'current' => 0,
-			'show_all' => false,
-			'prev_next' => false,
-			'prev_text' => __( '&laquo; Previous' ),
-			'next_text' => __( 'Next &raquo;' ),
-			'end_size' => 1,
-			'mid_size' => 2,
-			'type' => 'array',
-			'add_args' => false, // array of query args to add
-			'add_fragment' => ''
-		);
-		$args = wp_parse_args( $args, $defaults );
-		// Who knows what else people pass in $args
-		$args['total'] = intval( (int)$args['total'] );
-		if ( $args['total'] < 2 ) {
-			return array();
-		}
-		$args['current'] = (int)$args['current'];
-		$args['end_size'] = 0 < (int)$args['end_size'] ? (int)$args['end_size'] : 1; // Out of bounds?  Make it the default.
-		$args['mid_size'] = 0 <= (int)$args['mid_size'] ? (int)$args['mid_size'] : 2;
-		$args['add_args'] = is_array( $args['add_args'] ) ? $args['add_args'] : false;
-		$page_links = array();
-		$dots = false;
-		for ( $n = 1; $n <= $args['total']; $n++ ) {
-			$n_display = number_format_i18n( $n );
-			if ( $n == $args['current'] ) {
-				$page_links[] = array(
-					'class' => 'page-number page-numbers current',
-					'title' => $n_display,
-					'text' => $n_display,
-					'name' => $n_display,
-					'current' => true
-				);
-				$dots = true;
-			} else {
-				if ( $args['show_all'] || ( $n <= $args['end_size'] || ( $args['current'] && $n >= $args['current'] - $args['mid_size'] && $n <= $args['current'] + $args['mid_size'] ) || $n > $args['total'] - $args['end_size'] ) ) {
-					$link = str_replace( '%_%', 1 == $n ? '' : $args['format'], $args['base'] );
-					$link = str_replace( '%#%', $n, $link );
-					$link = trailingslashit( $link ) . ltrim( $args['add_fragment'], '/' );
-					if ( $args['add_args'] ) {
-						$link = rtrim( add_query_arg( $args['add_args'], $link ), '/' );
-					}
-					$link = str_replace(' ', '+', $link);
-					$link = untrailingslashit( $link );
-					$page_links[] = array(
-						'class' => 'page-number page-numbers',
-						'link' => esc_url( apply_filters( 'paginate_links', $link ) ),
-						'title' => $n_display,
-						'name' => $n_display,
-						'current' => $args['current'] == $n
-					);
-					$dots = true;
-				} elseif ( $dots && !$args['show_all'] ) {
-					$page_links[] = array(
-						'class' => 'dots',
-						'title' => __( '&hellip;' )
-					);
-					$dots = false;
-				}
-			}
-		}
-		return $page_links;
-	}
-
-	/**
-	 * @deprecated 0.18.0
-	 */
-	static function get_current_url() {
-		return TimberURLHelper::get_current_url();
-	}
-
-	/**
-	 * @deprecated 0.18.0
-	 */
-	static function is_url( $url ) {
-		return TimberURLHelper::is_url( $url );
-	}
-
-	/**
-	 * @deprecated 0.18.0
-	 */
-	static function get_path_base() {
-		return TimberURLHelper::get_path_base();
-	}
-
-	/**
-	 * @deprecated 0.18.0
-	 */
-	static function get_rel_url( $url, $force = false ) {
-		return TimberURLHelper::get_rel_url( $url, $force );
-	}
-
-	/**
-	 * @deprecated 0.18.0
-	 */
-	static function is_local( $url ) {
-		return TimberURLHelper::is_local( $url );
-	}
-
-	/**
-	 * @deprecated 0.18.0
-	 */
-	static function get_full_path( $src ) {
-		return TimberURLHelper::get_full_path( $src );
-	}
-
-	/**
-	 * @deprecated 0.18.0
-	 */
-	static function get_rel_path( $src ) {
-		return TimberURLHelper::get_rel_path( $src );
-	}
-
-	/**
-	 * @deprecated 0.18.0
-	 */
-	static function remove_double_slashes( $url ) {
-		return TimberURLHelper::remove_double_slashes( $url );
-	}
-
-	/**
-	 * @deprecated 0.18.0
-	 */
-	static function prepend_to_url( $url, $path ) {
-		return TimberURLHelper::prepend_to_url( $url, $path );
-	}
-
-	/**
-	 * @deprecated 0.18.0
-	 */
-	static function preslashit( $path ) {
-		return TimberURLHelper::preslashit( $path );
-	}
-
-	/**
-	 * @deprecated 0.18.0
-	 */
-	static function is_external( $url ) {
-		return TimberURLHelper::is_external( $url );
-	}
-
-	/**
-	 * @deprecated 0.18.0
-	 */
-	static function download_url( $url, $timeout = 300 ) {
-		return TimberURLHelper::download_url( $url, $timeout );
-	}
-
-	/**
-	 * @deprecated 0.18.0
-	 */
-	static function get_params( $i = -1 ) {
-		return TimberURLHelper::get_params( $i );
-	}
+    /**
+     *
+     * Gets the comment form for use on a single article page
+     * @deprecated 0.21.8 use `{{ function('comment_form') }}` instead
+     * @param int     $post_id which post_id should the form be tied to?
+     * @param array   $args this $args thing is a fucking mess, [fix at some point](http://codex.wordpress.org/Function_Reference/comment_form)
+     * @return string
+     */
+    public static function get_comment_form( $post_id = null, $args = array() ) {
+        return self::ob_function( 'comment_form', array( $args, $post_id ) );
+    }
+
+    /**
+     *
+     *
+     * @param string  $args
+     * @return array
+     */
+    public static function paginate_links( $args = '' ) {
+        $defaults = array(
+            'base' => '%_%', // http://example.com/all_posts.php%_% : %_% is replaced by format (below)
+            'format' => '?page=%#%', // ?page=%#% : %#% is replaced by the page number
+            'total' => 1,
+            'current' => 0,
+            'show_all' => false,
+            'prev_next' => false,
+            'prev_text' => __( '&laquo; Previous' ),
+            'next_text' => __( 'Next &raquo;' ),
+            'end_size' => 1,
+            'mid_size' => 2,
+            'type' => 'array',
+            'add_args' => false, // array of query args to add
+            'add_fragment' => ''
+        );
+        $args = wp_parse_args( $args, $defaults );
+        // Who knows what else people pass in $args
+        $args['total'] = intval( (int)$args['total'] );
+        if ( $args['total'] < 2 ) {
+            return array();
+        }
+        $args['current'] = (int)$args['current'];
+        $args['end_size'] = 0 < (int)$args['end_size'] ? (int)$args['end_size'] : 1; // Out of bounds?  Make it the default.
+        $args['mid_size'] = 0 <= (int)$args['mid_size'] ? (int)$args['mid_size'] : 2;
+        $args['add_args'] = is_array( $args['add_args'] ) ? $args['add_args'] : false;
+        $page_links = array();
+        $dots = false;
+        for ( $n = 1; $n <= $args['total']; $n++ ) {
+            $n_display = number_format_i18n( $n );
+            if ( $n == $args['current'] ) {
+                $page_links[] = array(
+                    'class' => 'page-number page-numbers current',
+                    'title' => $n_display,
+                    'text' => $n_display,
+                    'name' => $n_display,
+                    'current' => true
+                );
+                $dots = true;
+            } else {
+                if ( $args['show_all'] || ( $n <= $args['end_size'] || ( $args['current'] && $n >= $args['current'] - $args['mid_size'] && $n <= $args['current'] + $args['mid_size'] ) || $n > $args['total'] - $args['end_size'] ) ) {
+                    $link = str_replace( '%_%', 1 == $n ? '' : $args['format'], $args['base'] );
+                    $link = str_replace( '%#%', $n, $link );
+                    $link = trailingslashit( $link ) . ltrim( $args['add_fragment'], '/' );
+                    if ( $args['add_args'] ) {
+                        $link = rtrim( add_query_arg( $args['add_args'], $link ), '/' );
+                    }
+                    $link = str_replace(' ', '+', $link);
+                    $link = untrailingslashit( $link );
+                    $page_links[] = array(
+                        'class' => 'page-number page-numbers',
+                        'link' => esc_url( apply_filters( 'paginate_links', $link ) ),
+                        'title' => $n_display,
+                        'name' => $n_display,
+                        'current' => $args['current'] == $n
+                    );
+                    $dots = true;
+                } elseif ( $dots && !$args['show_all'] ) {
+                    $page_links[] = array(
+                        'class' => 'dots',
+                        'title' => __( '&hellip;' )
+                    );
+                    $dots = false;
+                }
+            }
+        }
+        return $page_links;
+    }
+
+    /**
+     * @deprecated 0.18.0
+     */
+    static function get_current_url() {
+        return TimberURLHelper::get_current_url();
+    }
+
+    /**
+     * @deprecated 0.18.0
+     */
+    static function is_url( $url ) {
+        return TimberURLHelper::is_url( $url );
+    }
+
+    /**
+     * @deprecated 0.18.0
+     */
+    static function get_path_base() {
+        return TimberURLHelper::get_path_base();
+    }
+
+    /**
+     * @deprecated 0.18.0
+     */
+    static function get_rel_url( $url, $force = false ) {
+        return TimberURLHelper::get_rel_url( $url, $force );
+    }
+
+    /**
+     * @deprecated 0.18.0
+     */
+    static function is_local( $url ) {
+        return TimberURLHelper::is_local( $url );
+    }
+
+    /**
+     * @deprecated 0.18.0
+     */
+    static function get_full_path( $src ) {
+        return TimberURLHelper::get_full_path( $src );
+    }
+
+    /**
+     * @deprecated 0.18.0
+     */
+    static function get_rel_path( $src ) {
+        return TimberURLHelper::get_rel_path( $src );
+    }
+
+    /**
+     * @deprecated 0.18.0
+     */
+    static function remove_double_slashes( $url ) {
+        return TimberURLHelper::remove_double_slashes( $url );
+    }
+
+    /**
+     * @deprecated 0.18.0
+     */
+    static function prepend_to_url( $url, $path ) {
+        return TimberURLHelper::prepend_to_url( $url, $path );
+    }
+
+    /**
+     * @deprecated 0.18.0
+     */
+    static function preslashit( $path ) {
+        return TimberURLHelper::preslashit( $path );
+    }
+
+    /**
+     * @deprecated 0.18.0
+     */
+    static function is_external( $url ) {
+        return TimberURLHelper::is_external( $url );
+    }
+
+    /**
+     * @deprecated 0.18.0
+     */
+    static function download_url( $url, $timeout = 300 ) {
+        return TimberURLHelper::download_url( $url, $timeout );
+    }
+
+    /**
+     * @deprecated 0.18.0
+     */
+    static function get_params( $i = -1 ) {
+        return TimberURLHelper::get_params( $i );
+    }
 
 }

lib/timber-post-getter.php

Indentation +87 added lines, -87 removed lines

@@ -2,103 +2,103 @@
 
 class TimberPostGetter {
 
-	/**
-	 * @param mixed $query
-	 * @param string $PostClass
-	 * @return array|bool|null
-	 */
-	static function get_post($query = false, $PostClass = 'TimberPost') {
-		$posts = self::get_posts( $query, $PostClass );
-		if ( $post = reset($posts ) ) {
-			return $post;
-		}
-	}
+    /**
+     * @param mixed $query
+     * @param string $PostClass
+     * @return array|bool|null
+     */
+    static function get_post($query = false, $PostClass = 'TimberPost') {
+        $posts = self::get_posts( $query, $PostClass );
+        if ( $post = reset($posts ) ) {
+            return $post;
+        }
+    }
 
-	static function get_posts( $query = false, $PostClass = 'TimberPost', $return_collection = false ) {
-		$posts = self::query_posts( $query, $PostClass );
-		return apply_filters('timber_post_getter_get_posts', $posts->get_posts( $return_collection ));
-	}
+    static function get_posts( $query = false, $PostClass = 'TimberPost', $return_collection = false ) {
+        $posts = self::query_posts( $query, $PostClass );
+        return apply_filters('timber_post_getter_get_posts', $posts->get_posts( $return_collection ));
+    }
 
-	static function query_post( $query = false, $PostClass = 'TimberPost' ) {
-		$posts = self::query_posts( $query, $PostClass );
-		if ( method_exists($posts, 'current') && $post = $posts->current() ) {
-			return $post;
-		}
-	}
+    static function query_post( $query = false, $PostClass = 'TimberPost' ) {
+        $posts = self::query_posts( $query, $PostClass );
+        if ( method_exists($posts, 'current') && $post = $posts->current() ) {
+            return $post;
+        }
+    }
 
-	/**
-	 * @param mixed $query
-	 * @param string $PostClass
-	 * @return array|bool|null
-	 */
-	static function query_posts($query = false, $PostClass = 'TimberPost' ) {
-		if (self::is_post_class_or_class_map($query)) {
-			$PostClass = $query;
-			$query = false;
-		}
+    /**
+     * @param mixed $query
+     * @param string $PostClass
+     * @return array|bool|null
+     */
+    static function query_posts($query = false, $PostClass = 'TimberPost' ) {
+        if (self::is_post_class_or_class_map($query)) {
+            $PostClass = $query;
+            $query = false;
+        }
 
-		if (is_object($query) && !is_a($query, 'WP_Query') ){
-			// The only object other than a query is a type of post object
-			$query = array( $query );
-		}
+        if (is_object($query) && !is_a($query, 'WP_Query') ){
+            // The only object other than a query is a type of post object
+            $query = array( $query );
+        }
 
-		if ( is_array( $query ) && count( $query ) && isset( $query[0] ) && is_object( $query[0] ) ) {
-			// We have an array of post objects that already have data
-			return new TimberPostsCollection( $query, $PostClass );
-		} else {
-			// We have a query (of sorts) to work with
-			$tqi = new TimberQueryIterator( $query, $PostClass );
-			return $tqi;
-		}
-	}
+        if ( is_array( $query ) && count( $query ) && isset( $query[0] ) && is_object( $query[0] ) ) {
+            // We have an array of post objects that already have data
+            return new TimberPostsCollection( $query, $PostClass );
+        } else {
+            // We have a query (of sorts) to work with
+            $tqi = new TimberQueryIterator( $query, $PostClass );
+            return $tqi;
+        }
+    }
 
-	static function get_pids($query){
-		$posts = self::get_posts($query);
-		$pids = array();
-		foreach($posts as $post){
-			if (isset($post->ID)){
-				$pids[] = $post->ID;
-			}
-		}
-		return $pids;
-	}
+    static function get_pids($query){
+        $posts = self::get_posts($query);
+        $pids = array();
+        foreach($posts as $post){
+            if (isset($post->ID)){
+                $pids[] = $post->ID;
+            }
+        }
+        return $pids;
+    }
 
-	static function loop_to_id() {
-		if (!self::wp_query_has_posts()) { return false; }
+    static function loop_to_id() {
+        if (!self::wp_query_has_posts()) { return false; }
 
-		global $wp_query;
-		$post_num = property_exists($wp_query, 'current_post')
-				  ? $wp_query->current_post + 1
-				  : 0
-				  ;
+        global $wp_query;
+        $post_num = property_exists($wp_query, 'current_post')
+                  ? $wp_query->current_post + 1
+                  : 0
+                    ;
 
-		if (!isset($wp_query->posts[$post_num])) { return false; }
+        if (!isset($wp_query->posts[$post_num])) { return false; }
 
-		return $wp_query->posts[$post_num]->ID;
-	}
+        return $wp_query->posts[$post_num]->ID;
+    }
 
-	/**
-	 * @return bool
-	 */
-	static function wp_query_has_posts() {
-		global $wp_query;
-		return ($wp_query && property_exists($wp_query, 'posts') && $wp_query->posts);
-	}
+    /**
+     * @return bool
+     */
+    static function wp_query_has_posts() {
+        global $wp_query;
+        return ($wp_query && property_exists($wp_query, 'posts') && $wp_query->posts);
+    }
 
-	/**
-	 * @param string|array $arg
-	 * @return bool
-	 */
-	static function is_post_class_or_class_map($arg){
-		if (is_string($arg) && class_exists($arg)) {
-			return true;
-		}
-		if (is_array($arg)) {
-			foreach ($arg as $item) {
-				if (is_string($item) && (class_exists($item) && is_subclass_of($item, 'TimberPost'))) {
-					return true;
-				}
-			}
-		}
-	}
+    /**
+     * @param string|array $arg
+     * @return bool
+     */
+    static function is_post_class_or_class_map($arg){
+        if (is_string($arg) && class_exists($arg)) {
+            return true;
+        }
+        if (is_array($arg)) {
+            foreach ($arg as $item) {
+                if (is_string($item) && (class_exists($item) && is_subclass_of($item, 'TimberPost'))) {
+                    return true;
+                }
+            }
+        }
+    }
 }

lib/timber-post.php

Indentation +1404 added lines, -1404 removed lines

@@ -34,1409 +34,1409 @@
  */
 class TimberPost extends TimberCore implements TimberCoreInterface {
 
-	/**
-	 * @var string $ImageClass the name of the class to handle images by default
-	 */
-	public $ImageClass = 'TimberImage';
-
-	/**
-	 * @var string $PostClass the name of the class to handle posts by default
-	 */
-	public $PostClass = 'TimberPost';
-
-	/**
-	 * @var string $TermClass the name of the class to handle terms by default
-	 */
-	public $TermClass = 'TimberTerm';
-
-	/**
-	 * @var string $object_type what does this class represent in WordPress terms?
-	 */
-	public $object_type = 'post';
-
-	/**
-	 * @var string $representation what does this class represent in WordPress terms?
-	 */
-	public static $representation = 'post';
-
-	/**
-	 * @internal
-	 * @var string $_content stores the processed content internally
-	 */
-	protected $_content;
-
-	/**
-	 * @internal
-	 * @var array $_get_terms stores the results of a get_terms method call
-	 * @deprecated
-	 */
-	protected $_get_terms;
-
-	/**
-	 * @var string $_permalink the returned permalink from WP's get_permalink function
-	 */
-	protected $_permalink;
-
-	/**
-	 * @var array $_next stores the results of the next TimberPost in a set inside an array (in order to manage by-taxonomy)
-	 */
-	protected $_next = array();
-
-	/**
-	 * @var array $_prev stores the results of the previous TimberPost in a set inside an array (in order to manage by-taxonomy)
-	 */
-	protected $_prev = array();
-
-	/**
-	 * @api
-	 * @var string $class stores the CSS classes for the post (ex: "post post-type-book post-123")
-	 */
-	public $class;
-
-	/**
-	 * @api
-	 * @var string $id the numeric WordPress id of a post
-	 */
-	public $id;
-
-	/**
-	 * @var string 	$ID 			the numeric WordPress id of a post, capitalized to match WP usage
-	 */
-	public $ID;
-
-	/**
-	 * @var int 	$post_author 	the numeric ID of the a post's author corresponding to the wp_user dtable
-	 */
-	public $post_author;
-
-	/**
-	 * @var string 	$post_content 	the raw text of a WP post as stored in the database
-	 */
-	public $post_content;
-
-	/**
-	 * @var string 	$post_date 		the raw date string as stored in the WP database, ex: 2014-07-05 18:01:39
-	 */
-	public $post_date;
-
-	/**
-	 * @var string 	$post_exceprt 	the raw text of a manual post exceprt as stored in the database
-	 */
-	public $post_excerpt;
-
-	/**
-	 * @var int 		$post_parent 	the numeric ID of a post's parent post
-	 */
-	public $post_parent;
-
-	/**
-	 * @api
-	 * @var string 		$post_status 	the status of a post ("draft", "publish", etc.)
-	 */
-	public $post_status;
-
-	/**
-	 * @var string 	$post_title 	the raw text of a post's title as stored in the database
-	 */
-	public $post_title;
-
-	/**
-	 * @api
-	 * @var string 	$post_type 		the name of the post type, this is the machine name (so "my_custom_post_type" as opposed to "My Custom Post Type")
-	 */
-	public $post_type;
-
-	/**
-	 * @api
-	 * @var string 	$slug 		the URL-safe slug, this corresponds to the poorly-named "post_name" in the WP database, ex: "hello-world"
-	 */
-	public $slug;
-
-	/**
-	 * If you send the constructor nothing it will try to figure out the current post id based on being inside The_Loop
-	 * @example
-	 * ```php
-	 * $post = new TimberPost();
-	 * $other_post = new TimberPost($random_post_id);
-	 * ```
-	 * @param mixed $pid
-	 */
-	public function __construct($pid = null) {
-		$pid = $this->determine_id( $pid );
-		$this->init($pid);
-	}
-
-	/**
-	 * tries to figure out what post you want to get if not explictly defined (or if it is, allows it to be passed through)
-	 * @internal
-	 * @param mixed a value to test against
-	 * @return int the numberic id we should be using for this post object
-	 */
-	protected function determine_id($pid) {
-		global $wp_query;
-		if ( $pid === null &&
-			isset($wp_query->queried_object_id)
-			&& $wp_query->queried_object_id
-			&& isset($wp_query->queried_object)
-			&& is_object($wp_query->queried_object)
-			&& get_class($wp_query->queried_object) == 'WP_Post'
-			) {
-				if( isset( $_GET['preview'] ) && isset( $_GET['preview_nonce'] ) && wp_verify_nonce( $_GET['preview_nonce'], 'post_preview_' . $wp_query->queried_object_id ) ) {
-					$pid = $this->get_post_preview_id( $wp_query );
-				} else if ( !$pid ) {
-					$pid = $wp_query->queried_object_id;
-				}
-		} else if ( $pid === null && $wp_query->is_home && isset($wp_query->queried_object_id) && $wp_query->queried_object_id )  {
-			//hack for static page as home page
-			$pid = $wp_query->queried_object_id;
-		} else if ( $pid === null ) {
-			$gtid = false;
-			$maybe_post = get_post();
-			if ( isset($maybe_post->ID) ){
-				$gtid = true;
-			}
-			if ( $gtid ) {
-				$pid = get_the_ID();
-			}
-			if ( !$pid ) {
-				global $wp_query;
-				if ( isset($wp_query->query['p']) ) {
-					$pid = $wp_query->query['p'];
-				}
-			}
-		}
-		if ( $pid === null && ($pid_from_loop = TimberPostGetter::loop_to_id()) ) {
-			$pid = $pid_from_loop;
-		}
-		return $pid;
-	}
-
-	/**
-	 * Outputs the title of the post if you do something like `<h1>{{post}}</h1>`
-	 * @return string
-	 */
-	public function __toString() {
-		return $this->title();
-	}
-
-	protected function get_post_preview_id( $query ) {
-		$can = array(
-	 		'edit_' . $query->queried_object->post_type . 's',
-	 	);
-
-	 	if ( $query->queried_object->author_id !== get_current_user_id() ) {
-	 		$can[] = 'edit_others_' . $query->queried_object->post_type . 's';
-	 	}
-
-	 	$can_preview = array();
-
-		foreach( $can as $type ) {
-		     if( current_user_can( $type ) ) {
-		        $can_preview[] = true;
-		     }
-		}
-
-		if ( count( $can_preview ) !== count( $can ) ) {
-		     return;
-		}
-
-		$revisions = wp_get_post_revisions( $query->queried_object_id );
-
-		if( !empty( $revisions ) ) {
-			$last = end($revisions);
-			return $last->ID;
-		}
-
-		return false;
-	}
-
-	/**
-	 * Initializes a TimberPost
-	 * @internal
-	 * @param int|bool $pid
-	 */
-	protected function init($pid = false) {
-		if ( $pid === false ) {
-			$pid = get_the_ID();
-		}
-		if ( is_numeric($pid) ) {
-			$this->ID = $pid;
-		}
-		$post_info = $this->get_info($pid);
-		$this->import($post_info);
-		//cant have a function, so gots to do it this way
-		$post_class = $this->post_class();
-		$this->class = $post_class;
-	}
-
-	/**
-	 * Get the URL that will edit the current post/object
-	 * @internal
-	 * @see TimberPost::edit_link
-	 * @return bool|string
-	 */
-	function get_edit_url() {
-		if ( $this->can_edit() ) {
-			return get_edit_post_link($this->ID);
-		}
-	}
-
-	/**
-	 * updates the post_meta of the current object with the given value
-	 * @param string $field
-	 * @param mixed $value
-	 */
-	public function update( $field, $value ) {
-		if ( isset($this->ID) ) {
-			update_post_meta($this->ID, $field, $value);
-			$this->$field = $value;
-		}
-	}
-
-
-	/**
-	 * takes a mix of integer (post ID), string (post slug),
-	 * or object to return a WordPress post object from WP's built-in get_post() function
-	 * @internal
-	 * @param mixed $pid
-	 * @return WP_Post on success
-	 */
-	protected function prepare_post_info( $pid = 0 ) {
-		if ( is_string($pid) || is_numeric($pid) || (is_object($pid) && !isset($pid->post_title)) || $pid === 0 ) {
-			$pid = self::check_post_id($pid);
-			$post = get_post($pid);
-			if ( $post ) {
-				return $post;
-			}
-		}
-		//we can skip if already is WP_Post
-		return $pid;
-	}
-
-
-	/**
-	 * helps you find the post id regardless of whether you send a string or whatever
-	 * @param integer $pid ;
-	 * @internal
-	 * @return integer ID number of a post
-	 */
-	protected function check_post_id( $pid ) {
-		if ( is_numeric($pid) && $pid === 0 ) {
-			$pid = get_the_ID();
-			return $pid;
-		}
-		if ( !is_numeric($pid) && is_string($pid) ) {
-			$pid = self::get_post_id_by_name($pid);
-			return $pid;
-		}
-		if ( !$pid ) {
-			return null;
-		}
-		return $pid;
-	}
-
-
-	/**
-	 * get_post_id_by_name($post_name)
-	 * @internal
-	 * @param string $post_name
-	 * @return int
-	 */
-	static function get_post_id_by_name($post_name) {
-		global $wpdb;
-		$query = $wpdb->prepare("SELECT ID FROM $wpdb->posts WHERE post_name = %s LIMIT 1", $post_name);
-		$result = $wpdb->get_row($query);
-		if (!$result) {
-			return null;
-		}
-		return $result->ID;
-	}
-
-	/**
-	 * get a preview of your post, if you have an excerpt it will use that,
-	 * otherwise it will pull from the post_content.
-	 * If there's a <!-- more --> tag it will use that to mark where to pull through.
-	 * @api
-	 * @example
-	 * ```twig
-	 * <p>{{post.get_preview(50)}}</p>
-	 * ```
-	 * @param int $len The number of words that WP should use to make the tease. (Isn't this better than [this mess](http://wordpress.org/support/topic/changing-the-default-length-of-the_excerpt-1?replies=14)?). If you've set a post_excerpt on a post, we'll use that for the preview text; otherwise the first X words of the post_content
-	 * @param bool $force What happens if your custom post excerpt is longer then the length requested? By default (`$force = false`) it will use the full `post_excerpt`. However, you can set this to true to *force* your excerpt to be of the desired length
-	 * @param string $readmore The text you want to use on the 'readmore' link
-	 * @param bool|string $strip true for default, false for none, string for list of custom attributes
-	 * @param string $end The text to end the preview with (defaults to ...)
-	 * @return string of the post preview
-	 */
-	function get_preview($len = 50, $force = false, $readmore = 'Read More', $strip = true, $end = '&hellip;') {
-		$text = '';
-		$trimmed = false;
-		if ( isset($this->post_excerpt) && strlen($this->post_excerpt) ) {
-			if ( $force ) {
-				$text = TimberHelper::trim_words($this->post_excerpt, $len, false);
-				$trimmed = true;
-			} else {
-				$text = $this->post_excerpt;
-			}
-		}
-		if ( !strlen($text) && preg_match('/<!--\s?more(.*?)?-->/', $this->post_content, $readmore_matches) ) {
-			$pieces = explode($readmore_matches[0], $this->post_content);
-			$text = $pieces[0];
-			if ( $force ) {
-				$text = TimberHelper::trim_words($text, $len, false);
-				$trimmed = true;
-			}
-			$text = do_shortcode( $text );
-		}
-		if ( !strlen($text) ) {
-			$text = TimberHelper::trim_words($this->get_content(), $len, false);
-			$trimmed = true;
-		}
-		if ( !strlen(trim($text)) ) {
-			return trim($text);
-		}
-		if ( $strip ) {
-			$allowable_tags = (is_string($strip)) ? $strip : null;
-			$text = trim(strip_tags($text, $allowable_tags));
-		}
-		if ( strlen($text) ) {
-			$text = trim($text);
-			$last = $text[strlen($text) - 1];
-			if ( $last != '.' && $trimmed ) {
-				$text .= $end;
-			}
-			if ( !$strip ) {
-				$last_p_tag = strrpos($text, '</p>');
-				if ( $last_p_tag !== false ) {
-					$text = substr($text, 0, $last_p_tag);
-				}
-				if ( $last != '.' && $trimmed ) {
-					$text .= $end . ' ';
-				}
-			}
-			$read_more_class = apply_filters('timber/post/get_preview/read_more_class', "read-more");
-			if ( $readmore && isset($readmore_matches) && !empty($readmore_matches[1]) ) {
-				$text .= ' <a href="' . $this->get_permalink() . '" class="'.$read_more_class .'">' . trim($readmore_matches[1]) . '</a>';
-			} elseif ( $readmore ) {
-				$text .= ' <a href="' . $this->get_permalink() . '" class="'.$read_more_class .'">' . trim($readmore) . '</a>';
-			}
-			if ( !$strip && $last_p_tag && ( strpos($text, '<p>') || strpos($text, '<p ') ) ) {
-				$text .= '</p>';
-			}
-		}
-		return trim($text);
-	}
-
-	/**
-	 * gets the post custom and attaches it to the current object
-	 * @internal
-	 * @param bool|int $pid a post ID number
-	 */
-	function import_custom( $pid = false ) {
-		if ( !$pid ) {
-			$pid = $this->ID;
-		}
-		$customs = $this->get_post_custom($pid);
-		$this->import($customs);
-	}
-
-	/**
-	 * Used internally to fetch the metadata fields (wp_postmeta table)
-	 * and attach them to our TimberPost object
-	 * @internal
-	 * @param int $pid
-	 * @return array
-	 */
-	protected function get_post_custom( $pid ) {
-		apply_filters('timber_post_get_meta_pre', array(), $pid, $this);
-		$customs = get_post_custom($pid);
-		if ( !is_array($customs) || empty($customs) ) {
-			return array();
-		}
-		foreach ( $customs as $key => $value ) {
-			if ( is_array($value) && count($value) == 1 && isset($value[0]) ) {
-				$value = $value[0];
-			}
-			$customs[$key] = maybe_unserialize($value);
-		}
-		$customs = apply_filters('timber_post_get_meta', $customs, $pid, $this);
-		return $customs;
-	}
-
-	/**
-	 * @internal
-	 * @see TimberPost::thumbnail
-	 * @return null|TimberImage
-	 */
-	function get_thumbnail() {
-		if ( function_exists('get_post_thumbnail_id') ) {
-			$tid = get_post_thumbnail_id($this->ID);
-			if ( $tid ) {
-				return new $this->ImageClass($tid);
-			}
-		}
-	}
-
-	/**
-	 * @internal
-	 * @see TimberPost::link
-	 * @return string
-	 */
-	function get_permalink() {
-		if ( isset($this->_permalink) ) {
-			return $this->_permalink;
-		}
-		$this->_permalink = get_permalink($this->ID);
-		return $this->_permalink;
-	}
-
-	/**
-	 * get the permalink for a post object
-	 * In your templates you should use link:
-	 * <a href="{{post.link}}">Read my post</a>
-	 * @internal
-	 * @return string
-	 */
-	function get_link() {
-		return $this->get_permalink();
-	}
-
-	/**
-	 * Get the next post in WordPress's ordering
-	 * @internal
-	 * @param bool $taxonomy
-	 * @return TimberPost|boolean
-	 */
-	function get_next( $taxonomy = false ) {
-		if ( !isset($this->_next) || !isset($this->_next[$taxonomy]) ) {
-			global $post;
-			$this->_next = array();
-			$old_global = $post;
-			$post = $this;
-			if ( $taxonomy ) {
-				$adjacent = get_adjacent_post(true, '', false, $taxonomy);
-			} else {
-				$adjacent = get_adjacent_post(false, '', false);
-			}
-
-			if ( $adjacent ) {
-				$this->_next[$taxonomy] = new $this->PostClass($adjacent);
-			} else {
-				$this->_next[$taxonomy] = false;
-			}
-			$post = $old_global;
-		}
-		return $this->_next[$taxonomy];
-	}
-
-	/**
-	 * Get a data array of pagination so you can navigate to the previous/next for a paginated post
-	 * @return array
-	 */
-	public function get_pagination() {
-		global $post, $page, $numpages, $multipage;
-		$post = $this;
-		$ret = array();
-		if ( $multipage ) {
-			for ( $i = 1; $i <= $numpages; $i++ ) {
-				$link = self::get_wp_link_page($i);
-				$data = array('name' => $i, 'title' => $i, 'text' => $i, 'link' => $link);
-				if ( $i == $page ) {
-					$data['current'] = true;
-				}
-				$ret['pages'][] = $data;
-			}
-			$i = $page - 1;
-			if ( $i ) {
-				$link = self::get_wp_link_page($i);
-				$ret['prev'] = array('link' => $link);
-			}
-			$i = $page + 1;
-			if ( $i <= $numpages ) {
-				$link = self::get_wp_link_page($i);
-				$ret['next'] = array('link' => $link);
-			}
-		}
-		return $ret;
-	}
-
-	/**
-	 * @param int $i
-	 * @return string
-	 */
-	protected static function get_wp_link_page($i) {
-		$link = _wp_link_page($i);
-		$link = new SimpleXMLElement($link . '</a>');
-		if ( isset($link['href']) ) {
-			return $link['href'];
-		}
-		return '';
-	}
-
-	/**
-	 * Get the permalink for a post, but as a relative path
-	 * For example, where {{post.link}} would return "http://example.org/2015/07/04/my-cool-post"
-	 * this will return the relative version: "/2015/07/04/my-cool-post"
-	 * @internal
-	 * @return string
-	 */
-	function get_path() {
-		return TimberURLHelper::get_rel_url($this->get_link());
-	}
-
-	/**
-	 * Get the next post in WordPress's ordering
-	 * @internal
-	 * @param bool $taxonomy
-	 * @return TimberPost|boolean
-	 */
-	function get_prev( $taxonomy = false ) {
-		if ( isset($this->_prev) && isset($this->_prev[$taxonomy]) ) {
-			return $this->_prev[$taxonomy];
-		}
-		global $post;
-		$old_global = $post;
-		$post = $this;
-		$within_taxonomy = ($taxonomy) ? $taxonomy : 'category';
-		$adjacent = get_adjacent_post(($taxonomy), '', true, $within_taxonomy);
-		$prev_in_taxonomy = false;
-		if ( $adjacent ) {
-			$prev_in_taxonomy = new $this->PostClass($adjacent);
-		}
-		$this->_prev[$taxonomy] = $prev_in_taxonomy;
-		$post = $old_global;
-		return $this->_prev[$taxonomy];
-	}
-
-	/**
-	 * Get the parent post of the post
-	 * @internal
-	 * @return bool|TimberPost
-	 */
-	function get_parent() {
-		if ( !$this->post_parent ) {
-			return false;
-		}
-		return new $this->PostClass($this->post_parent);
-	}
-
-	/**
-	 * Gets a User object from the author of the post
-	 * @internal
-	 * @see TimberPost::author
-	 * @return bool|TimberUser
-	 */
-	function get_author() {
-		if ( isset($this->post_author) ) {
-			return new TimberUser($this->post_author);
-		}
-	}
-
-	/**
-	 * @internal
-	 * @return bool|TimberUser
-	 */
-	function get_modified_author() {
-		$user_id = get_post_meta($this->ID, '_edit_last', true);
-		return ($user_id ? new TimberUser($user_id) : $this->get_author());
-	}
-
-	/**
-	 * Used internally by init, etc. to build TimberPost object
-	 * @internal
-	 * @param  int $pid
-	 * @return null|object|WP_Post
-	 */
-	protected function get_info($pid) {
-		$post = $this->prepare_post_info($pid);
-		if ( !isset($post->post_status) ) {
-			return null;
-		}
-		$post->status = $post->post_status;
-		$post->id = $post->ID;
-		$post->slug = $post->post_name;
-		$customs = $this->get_post_custom($post->ID);
-		$post->custom = $customs;
-		$post = (object) array_merge((array)$customs, (array)$post);
-		return $post;
-	}
-
-	/**
-	 * @internal
-	 * @see TimberPost::date
-	 * @param  string $date_format
-	 * @return string
-	 */
-	function get_date( $date_format = '' ) {
-		$df = $date_format ? $date_format : get_option('date_format');
-		$the_date = (string)mysql2date($df, $this->post_date);
-		return apply_filters('get_the_date', $the_date, $df);
-	}
-
-	/**
-	 * @internal
-	 * @param  string $date_format
-	 * @return string
-	 */
-	function get_modified_date( $date_format = '' ) {
-		$df = $date_format ? $date_format : get_option('date_format');
-		$the_time = $this->get_modified_time($df);
-		return apply_filters('get_the_modified_date', $the_time, $date_format);
-	}
-
-	/**
-	 * @internal
-	 * @param  string $time_format
-	 * @return string
-	 */
-	function get_modified_time( $time_format = '' ) {
-		$tf = $time_format ? $time_format : get_option('time_format');
-		$the_time = get_post_modified_time($tf, false, $this->ID, true);
-		return apply_filters('get_the_modified_time', $the_time, $time_format);
-	}
-
-	/**
-	 * @internal
-	 * @see TimberPost::children
-	 * @param string 		$post_type
-	 * @param bool|string 	$childPostClass
-	 * @return array
-	 */
-	function get_children( $post_type = 'any', $childPostClass = false ) {
-		if ( $childPostClass === false ) {
-			$childPostClass = $this->PostClass;
-		}
-		if ( $post_type == 'parent' ) {
-			$post_type = $this->post_type;
-		}
-		$children = get_children('post_parent=' . $this->ID . '&post_type=' . $post_type . '&numberposts=-1&orderby=menu_order title&order=ASC&post_status=publish');
-		foreach ( $children as &$child ) {
-			$child = new $childPostClass($child->ID);
-		}
-		$children = array_values($children);
-		return $children;
-	}
-
-
-	/**
-	 * Get the comments for a post
-	 * @internal
-	 * @see TimberPost::comments
-	 * @param int $ct
-	 * @param string $order
-	 * @param string $type
-	 * @param string $status
-	 * @param string $CommentClass
-	 * @return array|mixed
-	 */
-
-	function get_comments($ct = 0, $order = 'wp', $type = 'comment', $status = 'approve', $CommentClass = 'TimberComment') {
-
-		global $overridden_cpage, $user_ID;
-		$overridden_cpage = false;
-
-		$commenter = wp_get_current_commenter();
-		$comment_author_email = $commenter['comment_author_email'];
-
-		$args = array('post_id' => $this->ID, 'status' => $status, 'order' => $order);
-		if ( $ct > 0 ) {
-			$args['number'] = $ct;
-		}
-		if ( strtolower($order) == 'wp' || strtolower($order) == 'wordpress' ) {
-			$args['order'] = get_option('comment_order');
-		}
-
-		if ( $user_ID ) {
-			$args['include_unapproved'] = array( $user_ID );
-		} elseif ( ! empty( $comment_author_email ) ) {
-			$args['include_unapproved'] = array( $comment_author_email );
-		}
-
-		$comments = get_comments($args);
-		$timber_comments = array();
-
-		if ( '' == get_query_var('cpage') && get_option('page_comments') ) {
-			set_query_var( 'cpage', 'newest' == get_option('default_comments_page') ? get_comment_pages_count() : 1 );
-			$overridden_cpage = true;
-		}
-
-		foreach($comments as $key => &$comment) {
-			$timber_comment = new $CommentClass($comment);
-			$timber_comments[$timber_comment->id] = $timber_comment;
-		}
-
-		// Build a flattened (depth=1) comment tree
-		$comments_tree = array();
-		foreach( $timber_comments as $key => $comment ) {
-			if ( ! $comment->is_child() ) {
-				continue;
-			}
-
-			$tree_element = $comment;
-			do {
-				$tree_element = $timber_comments[$tree_element->comment_parent];
-			} while( $tree_element->is_child() );
-
-			$comments_tree[$tree_element->id][] = $comment->id;
-		}
-
-		// Add child comments to the relative "super parents"
-		foreach($comments_tree as $comment_parent => $comment_children) {
-			foreach($comment_children as $comment_child) {
-				$timber_comments[$comment_parent]->children[] = $timber_comments[$comment_child];
-				unset($timber_comments[$comment_child]);
-			}
-		}
-
-		$timber_comments = array_values($timber_comments);
-
-		return $timber_comments;
-	}
-
-	/**
-	 * Get the categories for a post
-	 * @internal
-	 * @see TimberPost::categories
-	 * @return array of TimberTerms
-	 */
-	function get_categories() {
-		return $this->get_terms('category');
-	}
-
-	/**
-	 * @internal
-	 * @see TimberPost::category
-	 * @return mixed
-	 */
-	function get_category( ) {
-		$cats = $this->get_categories();
-		if ( count($cats) && isset($cats[0]) ) {
-			return $cats[0];
-		}
-	}
-
-	/**
-	 * @internal
-	 * @param string|array $tax
-	 * @param bool $merge
-	 * @param string $TermClass
-	 * @return array
-	 */
-	function get_terms( $tax = '', $merge = true, $TermClass = '' ) {
-
-		$TermClass = $TermClass ?: $this->TermClass;
-
-		if ( is_string($merge) && class_exists($merge) ) {
-			$TermClass = $merge;
-		}
-		if ( is_array($tax) ) {
-			$taxonomies = $tax;
-		}
-		if ( is_string($tax) ) {
-			if ( in_array($tax, array('all','any','')) ) {
-				$taxonomies = get_object_taxonomies($this->post_type);
-			} else {
-				$taxonomies = array($tax);
-			}
-		}
-
-		$term_class_objects = array();
-
-		foreach ( $taxonomies as $taxonomy ) {
-			if ( in_array($taxonomy, array('tag','tags')) ) {
-				$taxonomy = 'post_tag';
-			}
-			if ( $taxonomy == 'categories' ) {
-				$taxonomy = 'category';
-			}
-
-			$terms = wp_get_post_terms($this->ID, $taxonomy);
-
-			if ( is_wp_error($terms) ) {
-				/* @var $terms WP_Error */
-				TimberHelper::error_log("Error retrieving terms for taxonomy '$taxonomy' on a post in timber-post.php");
-				TimberHelper::error_log('tax = ' . print_r($tax, true));
-				TimberHelper::error_log('WP_Error: ' . $terms->get_error_message());
-
-				return $term_class_objects;
-			}
-
-			// map over array of wordpress terms, and transform them into instances of the TermClass
-			$terms = array_map(function($term) use ($TermClass, $taxonomy) {
-				return call_user_func(array($TermClass, 'from'), $term->term_id, $taxonomy);
-			}, $terms);
-
-			if ( $merge && is_array($terms) ) {
-				$term_class_objects = array_merge($term_class_objects, $terms);
-			} else if ( count($terms) ) {
-				$term_class_objects[$taxonomy] = $terms;
-			}
-		}
-		return $term_class_objects;
-	}
-
-	/**
-	 * @param string|int $term_name_or_id
-	 * @param string $taxonomy
-	 * @return bool
-	 */
-	function has_term( $term_name_or_id, $taxonomy = 'all' ) {
-		if ( $taxonomy == 'all' || $taxonomy == 'any' ) {
-			$taxes = get_object_taxonomies($this->post_type, 'names');
-			$ret = false;
-			foreach ( $taxes as $tax ) {
-				if ( has_term($term_name_or_id, $tax, $this->ID) ) {
-					$ret = true;
-					break;
-				}
-			}
-			return $ret;
-		}
-		return has_term($term_name_or_id, $taxonomy, $this->ID);
-	}
-
-	/**
-	 * @param string $field
-	 * @return TimberImage
-	 */
-	function get_image( $field ) {
-		return new $this->ImageClass($this->$field);
-	}
-
-	/**
-	 * Gets an array of tags for you to use
-	 * @internal
-	 * @example
-	 * ```twig
-	 * <ul class="tags">
-	 *     {% for tag in post.tags %}
-	 *         <li>{{tag.name}}</li>
-	 *     {% endfor %}
-	 * </ul>
-	 * ```
-	 * @return array
-	 */
-	function get_tags() {
-		return $this->get_terms('post_tag');
-	}
-
-	/**
-	 * Outputs the title with filters applied
-	 * @internal
-	 * @example
-	 * ```twig
-	 * <h1>{{post.get_title}}</h1>
-	 * ```
-	 * ```html
-	 * <h1>Hello World!</h1>
-	 * ```
-	 * @return string
-	 */
-	function get_title() {
-		return apply_filters('the_title', $this->post_title, $this->ID);
-	}
-
-	/**
-	 * Displays the content of the post with filters, shortcodes and wpautop applied
-	 * @example
-	 * ```twig
-	 * <div class="article-text">{{post.get_content}}</div>
-	 * ```
-	 * ```html
-	 * <div class="article-text"><p>Blah blah blah</p><p>More blah blah blah.</p></div>
-	 * ```
-	 * @param int $len
-	 * @param int $page
-	 * @return string
-	 */
-	function get_content( $len = 0, $page = 0 ) {
-		if ( $len == 0 && $page == 0 && $this->_content ) {
-			return $this->_content;
-		}
-		$content = $this->post_content;
-		if ( $len ) {
-			$content = wp_trim_words($content, $len);
-		}
-		if ( $page ) {
-			$contents = explode('<!--nextpage-->', $content);
-			$page--;
-			if ( count($contents) > $page ) {
-				$content = $contents[$page];
-			}
-		}
-		$content = apply_filters('the_content', ($content));
-		if ( $len == 0 && $page == 0 ) {
-			$this->_content = $content;
-		}
-		return $content;
-	}
-
-	/**
-	 * @return string
-	 */
-	function get_paged_content() {
-		global $page;
-		return $this->get_content(0, $page);
-	}
-	/**
-	 *
-	 * Here is my summary
-	 * @example
-	 * ```twig
-	 * This post is from <span>{{ post.get_post_type.labels.plural }}</span>
-	 * ```
-	 *
-	 * ```html
-	 * This post is from <span>Recipes</span>
-	 * ```
-	 * @return mixed
-	 */
-	public function get_post_type() {
-		return get_post_type_object($this->post_type);
-	}
-
-	/**
-	 * @return int the number of comments on a post
-	 */
-	public function get_comment_count() {
-		return get_comments_number($this->ID);
-	}
-
-	/**
-	 * @param string $field_name
-	 * @return mixed
-	 */
-	public function get_field( $field_name ) {
-		$value = apply_filters('timber_post_get_meta_field_pre', null, $this->ID, $field_name, $this);
-		if ( $value === null ) {
-			$value = get_post_meta($this->ID, $field_name);
-			if ( is_array($value) && count($value) == 1 ) {
-				$value = $value[0];
-			}
-			if ( is_array($value) && count($value) == 0 ) {
-				$value = null;
-			}
-		}
-		$value = apply_filters('timber_post_get_meta_field', $value, $this->ID, $field_name, $this);
-		return $value;
-	}
-
-	/**
-	 * @param string $field_name
-	 */
-	function import_field( $field_name ) {
-		$this->$field_name = $this->get_field($field_name);
-	}
-
-	/**
-	 * @internal
-	 * @return mixed
-	 */
-	function get_format() {
-		return get_post_format($this->ID);
-	}
-
-	/**
-	 * Get the CSS classes for a post. For usage you should use `{{post.class}}` instead of `{{post.post_class}}`
-	 * @internal
-	 * @param string $class additional classes you want to add
-	 * @see TimberPost::$class
-	 * @example
-	 * ```twig
-	 * <article class="{{ post.class }}">
-	 *    {# Some stuff here #}
-	 * </article>
-	 * ```
-	 *
-	 * ```html
-	 * <article class="post-2612 post type-post status-publish format-standard has-post-thumbnail hentry category-data tag-charleston-church-shooting tag-dylann-roof tag-gun-violence tag-hate-crimes tag-national-incident-based-reporting-system">
-	 *    {# Some stuff here #}
-	 * </article>
-	 * ```
-	 * @return string a space-seperated list of classes
-	 */
-	public function post_class( $class='' ) {
-		global $post;
-		$old_global_post = $post;
-		$post = $this;
-		$class_array = get_post_class($class, $this->ID);
-		$post = $old_global_post;
-		if ( is_array($class_array) ){
-			return implode(' ', $class_array);
-		}
-		return $class_array;
-	}
-
-	// Docs
-
-	/**
-	 * @return array
-	 * @codeCoverageIgnore
-	 */
-	public function get_method_values() {
-		$ret = parent::get_method_values();
-		$ret['author'] = $this->author();
-		$ret['categories'] = $this->categories();
-		$ret['category'] = $this->category();
-		$ret['children'] = $this->children();
-		$ret['comments'] = $this->comments();
-		$ret['content'] = $this->content();
-		$ret['edit_link'] = $this->edit_link();
-		$ret['format'] = $this->format();
-		$ret['link'] = $this->link();
-		$ret['next'] = $this->next();
-		$ret['pagination'] = $this->pagination();
-		$ret['parent'] = $this->parent();
-		$ret['path'] = $this->path();
-		$ret['prev'] = $this->prev();
-		$ret['terms'] = $this->terms();
-		$ret['tags'] = $this->tags();
-		$ret['thumbnail'] = $this->thumbnail();
-		$ret['title'] = $this->title();
-		return $ret;
-	}
-
-	/**
-	 * Return the author of a post
-	 * @api
-	 * @example
-	 * ```twig
-	 * <h1>{{post.title}}</h1>
-	 * <p class="byline">
-	 *     <a href="{{post.author.link}}">{{post.author.name}}</a>
-	 * </p>
-	 * ```
-	 * @return TimberUser|bool A TimberUser object if found, false if not
-	 */
-	public function author() {
-		return $this->get_author();
-	}
-
-	/**
-	 * Get the author (WordPress user) who last modified the post
-	 * @example
-	 * ```twig
-	 * Last updated by {{ post.modified_author.name }}
-	 * ```
-	 * ```html
-	 * Last updated by Harper Lee
-	 * ```
-	 * @return TimberUser|bool A TimberUser object if found, false if not
-	 */
-	public function modified_author() {
-		return $this->get_modified_author();
-	}
-
-	/**
-	 * Get the categoires on a particular post
-	 * @api
-	 * @return array of TimberTerms
-	 */
-	public function categories() {
-		return $this->get_terms('category');
-	}
-
-	/**
-	 * Returns a category attached to a post
-	 * @api
-	 * If mulitpuile categories are set, it will return just the first one
-	 * @return TimberTerm|null
-	 */
-	public function category() {
-		return $this->get_category();
-	}
-
-	/**
-	 * Returns an array of children on the post as TimberPosts
-	 * (or other claass as you define).
-	 * @api
-	 * @example
-	 * ```twig
-	 * {% if post.children %}
-	 *     Here are the child pages:
-	 *     {% for child in page.children %}
-	 *         <a href="{{ child.link }}">{{ child.title }}</a>
-	 *     {% endfor %}
-	 * {% endif %}
-	 * ```
-	 * @param string $post_type _optional_ use to find children of a particular post type (attachment vs. page for example). You might want to restrict to certain types of children in case other stuff gets all mucked in there. You can use 'parent' to use the parent's post type
-	 * @param string|bool $childPostClass _optional_ a custom post class (ex: 'MyTimberPost') to return the objects as. By default (false) it will use TimberPost::$post_class value.
-	 * @return array
-	 */
-	public function children( $post_type = 'any', $childPostClass = false ) {
-		return $this->get_children( $post_type, $childPostClass );
-	}
-
-	/**
-	 * Gets the comments on a TimberPost and returns them as an array of [TimberComments](#TimberComment) (or whatever comment class you set).
-	 * @api
-	 * @param int $count Set the number of comments you want to get. `0` is analogous to "all"
-	 * @param string $order use ordering set in WordPress admin, or a different scheme
-	 * @param string $type For when other plugins use the comments table for their own special purposes, might be set to 'liveblog' or other depending on what's stored in yr comments table
-	 * @param string $status Could be 'pending', etc.
-	 * @param string $CommentClass What class to use when returning Comment objects. As you become a Timber pro, you might find yourself extending TimberComment for your site or app (obviously, totally optional)
-	 * @example
-	 * ```twig
-	 * {# single.twig #}
-	 * <h4>Comments:</h4>
-	 * {% for comment in post.comments %}
-	 * 	<div class="comment-{{comment.ID}} comment-order-{{loop.index}}">
-	 * 		<p>{{comment.author.name}} said:</p>
-	 * 		<p>{{comment.content}}</p>
-	 * 	</div>
-	 * {% endfor %}
-	 * ```
-	 * @return bool|array
-	 */
-	public function comments( $count = 0, $order = 'wp', $type = 'comment', $status = 'approve', $CommentClass = 'TimberComment' ) {
-		return $this->get_comments($count, $order, $type, $status, $CommentClass);
-	}
-
-	/**
-	 * Gets the actual content of a WP Post, as opposed to post_content this will run the hooks/filters attached to the_content. \This guy will return your posts content with WordPress filters run on it (like for shortcodes and wpautop).
-	 * @api
-	 * @example
-	 * ```twig
-	 * <div class="article">
-	 *     <h2>{{post.title}}</h2>
-	 *     <div class="content">{{ post.content }}</div>
-	 * </div>
-	 * ```
-	 * @param int $page
-	 * @return string
-	 */
-	public function content( $page = 0 ) {
-		return $this->get_content(0, $page);
-	}
-
-	/**
-	 * @return string
-	 */
-	public function paged_content() {
-		return $this->get_paged_content();
-	}
-
-	/**
-	 * Get the date to use in your template!
-	 * @api
-	 * @example
-	 * ```twig
-	 * Published on {{ post.date }} // Uses WP's formatting set in Admin
-	 * OR
-	 * Published on {{ post.date | date('F jS') }} // Jan 12th
-	 * ```
-	 *
-	 * ```html
-	 * Published on January 12, 2015
-	 * OR
-	 * Published on Jan 12th
-	 * ```
-	 * @param string $date_format
-	 * @return string
-	 */
-	public function date( $date_format = '' ) {
-		return $this->get_date($date_format);
-	}
-
-	/**
-	 * Get the time to use in your template
-	 * @api
-	 * @example
-	 * ```twig
-	 * Published at {{ post.time }} // Uses WP's formatting set in Admin
-	 * OR
-	 * Published at {{ post.time | time('G:i') }} // 13:25
-	 * ```
-	 *
-	 * ```html
-	 * Published at 1:25 pm
-	 * OR
-	 * Published at 13:25
-	 * ```
-	 * @param string $time_format
-	 * @return string
-	 */
-	public function time( $time_format = '' ) {
-		$tf = $time_format ? $time_format : get_option('time_format');
-	 	$the_time = (string)mysql2date($tf, $this->post_date);
-	 	return apply_filters('get_the_time', $the_time, $tf);
-	}
-
-	/**
-	 * @return bool|string
-	 */
-	public function edit_link() {
-		return $this->get_edit_url();
-	}
-
-	/**
-	 * @api
-	 * @return mixed
-	 */
-	public function format() {
-		return $this->get_format();
-	}
-
-	/**
-	 * get the permalink for a post object
-	 * @api
-	 * @example
-	 * ```twig
-	 * <a href="{{post.link}}">Read my post</a>
-	 * ```
-	 * @return string ex: http://example.org/2015/07/my-awesome-post
-	 */
-	public function link() {
-		return $this->get_permalink();
-	}
-
-	/**
-	 * @param string $field_name
-	 * @return mixed
-	 */
-	public function meta( $field_name = null ) {
-		if ( $field_name === null ) {
-			//on the off-chance the field is actually named meta
-			$field_name = 'meta';
-		}
-		return $this->get_field($field_name);
-	}
-
-	/**
-	 * @return string
-	 */
-	public function name(){
-		return $this->title();
-	}
-
-	/**
-	 * @param string $date_format
-	 * @return string
-	 */
-	public function modified_date( $date_format = '' ) {
-		return $this->get_modified_date($date_format);
-	}
-
-	/**
-	 * @param string $time_format
-	 * @return string
-	 */
-	public function modified_time( $time_format = '' ) {
-		return $this->get_modified_time($time_format);
-	}
-
-	/**
-	 * @api
-	 * @param bool $in_same_cat
-	 * @return mixed
-	 */
-	public function next( $in_same_cat = false ) {
-		return $this->get_next($in_same_cat);
-	}
-
-	/**
-	 * @return array
-	 */
-	public function pagination() {
-		return $this->get_pagination();
-	}
-
-	/**
-	 * Gets the parent (if one exists) from a post as a TimberPost object (or whatever is set in TimberPost::$PostClass)
-	 * @api
-	 * @example
-	 * ```twig
-	 * Parent page: <a href="{{ post.parent.link }}">{{ post.parent.title }}</a>
-	 * ```
-	 * @return bool|TimberPost
-	 */
-	public function parent() {
-		return $this->get_parent();
-	}
-
-	/**
-	 * Gets the relative path of a WP Post, so while link() will return http://example.org/2015/07/my-cool-post
-	 * this will return just /2015/07/my-cool-post
-	 * @api
-	 * @example
-	 * ```twig
-	 * <a href="{{post.path}}">{{post.title}}</a>
-	 * ```
-	 * @return string
-	 */
-	public function path() {
-		return $this->get_path();
-	}
-
-	/**
-	 * @deprecated 0.20.0 use link() instead
-	 * @return string
-	 */
-	public function permalink() {
-		return $this->get_permalink();
-	}
-
-	/**
-	 * Get the previous post in a set
-	 * @api
-	 * @example
-	 * ```twig
-	 * <h4>Prior Entry:</h4>
-	 * <h3>{{post.prev.title}}</h3>
-	 * <p>{{post.prev.get_preview(25)}}</p>
-	 * ```
-	 * @param bool $in_same_cat
-	 * @return mixed
-	 */
-	public function prev( $in_same_cat = false ) {
-		return $this->get_prev($in_same_cat);
-	}
-
-	/**
-	 * Get the terms associated with the post
-	 * This goes across all taxonomies by default
-	 * @api
-	 * @param string|array $tax What taxonom(y|ies) to pull from. Defaults to all registered taxonomies for the post type. You can use custom ones, or built-in WordPress taxonomies (category, tag). Timber plays nice and figures out that tag/tags/post_tag are all the same (and categories/category), for custom taxonomies you're on your own.
-	 * @param bool $merge Should the resulting array be one big one (true)? Or should it be an array of sub-arrays for each taxonomy (false)?
-	 * @return array
-	 */
-	public function terms( $tax = '', $merge = true ) {
-		return $this->get_terms($tax, $merge);
-	}
-
-	/**
-	 * Gets the tags on a post, uses WP's post_tag taxonomy
-	 * @api
-	 * @return array
-	 */
-	public function tags() {
-		return $this->get_tags();
-	}
-
-	/**
-	 * get the featured image as a TimberImage
-	 * @api
-	 * @example
-	 * ```twig
-	 * <img src="{{post.thumbnail.src}}" />
-	 * ```
-	 * @return TimberImage|null of your thumbnail
-	 */
-	public function thumbnail() {
-		return $this->get_thumbnail();
-	}
-
-	/**
-	 * Returns the processed title to be used in templates. This returns the title of the post after WP's filters have run. This is analogous to `the_title()` in standard WP template tags.
-	 * @api
-	 * @example
-	 * ```twig
-	 * <h1>{{ post.title }}</h1>
-	 * ```
-	 * @return string
-	 */
-	public function title() {
-		return $this->get_title();
-	}
+    /**
+     * @var string $ImageClass the name of the class to handle images by default
+     */
+    public $ImageClass = 'TimberImage';
+
+    /**
+     * @var string $PostClass the name of the class to handle posts by default
+     */
+    public $PostClass = 'TimberPost';
+
+    /**
+     * @var string $TermClass the name of the class to handle terms by default
+     */
+    public $TermClass = 'TimberTerm';
+
+    /**
+     * @var string $object_type what does this class represent in WordPress terms?
+     */
+    public $object_type = 'post';
+
+    /**
+     * @var string $representation what does this class represent in WordPress terms?
+     */
+    public static $representation = 'post';
+
+    /**
+     * @internal
+     * @var string $_content stores the processed content internally
+     */
+    protected $_content;
+
+    /**
+     * @internal
+     * @var array $_get_terms stores the results of a get_terms method call
+     * @deprecated
+     */
+    protected $_get_terms;
+
+    /**
+     * @var string $_permalink the returned permalink from WP's get_permalink function
+     */
+    protected $_permalink;
+
+    /**
+     * @var array $_next stores the results of the next TimberPost in a set inside an array (in order to manage by-taxonomy)
+     */
+    protected $_next = array();
+
+    /**
+     * @var array $_prev stores the results of the previous TimberPost in a set inside an array (in order to manage by-taxonomy)
+     */
+    protected $_prev = array();
+
+    /**
+     * @api
+     * @var string $class stores the CSS classes for the post (ex: "post post-type-book post-123")
+     */
+    public $class;
+
+    /**
+     * @api
+     * @var string $id the numeric WordPress id of a post
+     */
+    public $id;
+
+    /**
+     * @var string 	$ID 			the numeric WordPress id of a post, capitalized to match WP usage
+     */
+    public $ID;
+
+    /**
+     * @var int 	$post_author 	the numeric ID of the a post's author corresponding to the wp_user dtable
+     */
+    public $post_author;
+
+    /**
+     * @var string 	$post_content 	the raw text of a WP post as stored in the database
+     */
+    public $post_content;
+
+    /**
+     * @var string 	$post_date 		the raw date string as stored in the WP database, ex: 2014-07-05 18:01:39
+     */
+    public $post_date;
+
+    /**
+     * @var string 	$post_exceprt 	the raw text of a manual post exceprt as stored in the database
+     */
+    public $post_excerpt;
+
+    /**
+     * @var int 		$post_parent 	the numeric ID of a post's parent post
+     */
+    public $post_parent;
+
+    /**
+     * @api
+     * @var string 		$post_status 	the status of a post ("draft", "publish", etc.)
+     */
+    public $post_status;
+
+    /**
+     * @var string 	$post_title 	the raw text of a post's title as stored in the database
+     */
+    public $post_title;
+
+    /**
+     * @api
+     * @var string 	$post_type 		the name of the post type, this is the machine name (so "my_custom_post_type" as opposed to "My Custom Post Type")
+     */
+    public $post_type;
+
+    /**
+     * @api
+     * @var string 	$slug 		the URL-safe slug, this corresponds to the poorly-named "post_name" in the WP database, ex: "hello-world"
+     */
+    public $slug;
+
+    /**
+     * If you send the constructor nothing it will try to figure out the current post id based on being inside The_Loop
+     * @example
+     * ```php
+     * $post = new TimberPost();
+     * $other_post = new TimberPost($random_post_id);
+     * ```
+     * @param mixed $pid
+     */
+    public function __construct($pid = null) {
+        $pid = $this->determine_id( $pid );
+        $this->init($pid);
+    }
+
+    /**
+     * tries to figure out what post you want to get if not explictly defined (or if it is, allows it to be passed through)
+     * @internal
+     * @param mixed a value to test against
+     * @return int the numberic id we should be using for this post object
+     */
+    protected function determine_id($pid) {
+        global $wp_query;
+        if ( $pid === null &&
+            isset($wp_query->queried_object_id)
+            && $wp_query->queried_object_id
+            && isset($wp_query->queried_object)
+            && is_object($wp_query->queried_object)
+            && get_class($wp_query->queried_object) == 'WP_Post'
+            ) {
+                if( isset( $_GET['preview'] ) && isset( $_GET['preview_nonce'] ) && wp_verify_nonce( $_GET['preview_nonce'], 'post_preview_' . $wp_query->queried_object_id ) ) {
+                    $pid = $this->get_post_preview_id( $wp_query );
+                } else if ( !$pid ) {
+                    $pid = $wp_query->queried_object_id;
+                }
+        } else if ( $pid === null && $wp_query->is_home && isset($wp_query->queried_object_id) && $wp_query->queried_object_id )  {
+            //hack for static page as home page
+            $pid = $wp_query->queried_object_id;
+        } else if ( $pid === null ) {
+            $gtid = false;
+            $maybe_post = get_post();
+            if ( isset($maybe_post->ID) ){
+                $gtid = true;
+            }
+            if ( $gtid ) {
+                $pid = get_the_ID();
+            }
+            if ( !$pid ) {
+                global $wp_query;
+                if ( isset($wp_query->query['p']) ) {
+                    $pid = $wp_query->query['p'];
+                }
+            }
+        }
+        if ( $pid === null && ($pid_from_loop = TimberPostGetter::loop_to_id()) ) {
+            $pid = $pid_from_loop;
+        }
+        return $pid;
+    }
+
+    /**
+     * Outputs the title of the post if you do something like `<h1>{{post}}</h1>`
+     * @return string
+     */
+    public function __toString() {
+        return $this->title();
+    }
+
+    protected function get_post_preview_id( $query ) {
+        $can = array(
+                'edit_' . $query->queried_object->post_type . 's',
+            );
+
+            if ( $query->queried_object->author_id !== get_current_user_id() ) {
+                $can[] = 'edit_others_' . $query->queried_object->post_type . 's';
+            }
+
+            $can_preview = array();
+
+        foreach( $can as $type ) {
+                if( current_user_can( $type ) ) {
+                $can_preview[] = true;
+                }
+        }
+
+        if ( count( $can_preview ) !== count( $can ) ) {
+                return;
+        }
+
+        $revisions = wp_get_post_revisions( $query->queried_object_id );
+
+        if( !empty( $revisions ) ) {
+            $last = end($revisions);
+            return $last->ID;
+        }
+
+        return false;
+    }
+
+    /**
+     * Initializes a TimberPost
+     * @internal
+     * @param int|bool $pid
+     */
+    protected function init($pid = false) {
+        if ( $pid === false ) {
+            $pid = get_the_ID();
+        }
+        if ( is_numeric($pid) ) {
+            $this->ID = $pid;
+        }
+        $post_info = $this->get_info($pid);
+        $this->import($post_info);
+        //cant have a function, so gots to do it this way
+        $post_class = $this->post_class();
+        $this->class = $post_class;
+    }
+
+    /**
+     * Get the URL that will edit the current post/object
+     * @internal
+     * @see TimberPost::edit_link
+     * @return bool|string
+     */
+    function get_edit_url() {
+        if ( $this->can_edit() ) {
+            return get_edit_post_link($this->ID);
+        }
+    }
+
+    /**
+     * updates the post_meta of the current object with the given value
+     * @param string $field
+     * @param mixed $value
+     */
+    public function update( $field, $value ) {
+        if ( isset($this->ID) ) {
+            update_post_meta($this->ID, $field, $value);
+            $this->$field = $value;
+        }
+    }
+
+
+    /**
+     * takes a mix of integer (post ID), string (post slug),
+     * or object to return a WordPress post object from WP's built-in get_post() function
+     * @internal
+     * @param mixed $pid
+     * @return WP_Post on success
+     */
+    protected function prepare_post_info( $pid = 0 ) {
+        if ( is_string($pid) || is_numeric($pid) || (is_object($pid) && !isset($pid->post_title)) || $pid === 0 ) {
+            $pid = self::check_post_id($pid);
+            $post = get_post($pid);
+            if ( $post ) {
+                return $post;
+            }
+        }
+        //we can skip if already is WP_Post
+        return $pid;
+    }
+
+
+    /**
+     * helps you find the post id regardless of whether you send a string or whatever
+     * @param integer $pid ;
+     * @internal
+     * @return integer ID number of a post
+     */
+    protected function check_post_id( $pid ) {
+        if ( is_numeric($pid) && $pid === 0 ) {
+            $pid = get_the_ID();
+            return $pid;
+        }
+        if ( !is_numeric($pid) && is_string($pid) ) {
+            $pid = self::get_post_id_by_name($pid);
+            return $pid;
+        }
+        if ( !$pid ) {
+            return null;
+        }
+        return $pid;
+    }
+
+
+    /**
+     * get_post_id_by_name($post_name)
+     * @internal
+     * @param string $post_name
+     * @return int
+     */
+    static function get_post_id_by_name($post_name) {
+        global $wpdb;
+        $query = $wpdb->prepare("SELECT ID FROM $wpdb->posts WHERE post_name = %s LIMIT 1", $post_name);
+        $result = $wpdb->get_row($query);
+        if (!$result) {
+            return null;
+        }
+        return $result->ID;
+    }
+
+    /**
+     * get a preview of your post, if you have an excerpt it will use that,
+     * otherwise it will pull from the post_content.
+     * If there's a <!-- more --> tag it will use that to mark where to pull through.
+     * @api
+     * @example
+     * ```twig
+     * <p>{{post.get_preview(50)}}</p>
+     * ```
+     * @param int $len The number of words that WP should use to make the tease. (Isn't this better than [this mess](http://wordpress.org/support/topic/changing-the-default-length-of-the_excerpt-1?replies=14)?). If you've set a post_excerpt on a post, we'll use that for the preview text; otherwise the first X words of the post_content
+     * @param bool $force What happens if your custom post excerpt is longer then the length requested? By default (`$force = false`) it will use the full `post_excerpt`. However, you can set this to true to *force* your excerpt to be of the desired length
+     * @param string $readmore The text you want to use on the 'readmore' link
+     * @param bool|string $strip true for default, false for none, string for list of custom attributes
+     * @param string $end The text to end the preview with (defaults to ...)
+     * @return string of the post preview
+     */
+    function get_preview($len = 50, $force = false, $readmore = 'Read More', $strip = true, $end = '&hellip;') {
+        $text = '';
+        $trimmed = false;
+        if ( isset($this->post_excerpt) && strlen($this->post_excerpt) ) {
+            if ( $force ) {
+                $text = TimberHelper::trim_words($this->post_excerpt, $len, false);
+                $trimmed = true;
+            } else {
+                $text = $this->post_excerpt;
+            }
+        }
+        if ( !strlen($text) && preg_match('/<!--\s?more(.*?)?-->/', $this->post_content, $readmore_matches) ) {
+            $pieces = explode($readmore_matches[0], $this->post_content);
+            $text = $pieces[0];
+            if ( $force ) {
+                $text = TimberHelper::trim_words($text, $len, false);
+                $trimmed = true;
+            }
+            $text = do_shortcode( $text );
+        }
+        if ( !strlen($text) ) {
+            $text = TimberHelper::trim_words($this->get_content(), $len, false);
+            $trimmed = true;
+        }
+        if ( !strlen(trim($text)) ) {
+            return trim($text);
+        }
+        if ( $strip ) {
+            $allowable_tags = (is_string($strip)) ? $strip : null;
+            $text = trim(strip_tags($text, $allowable_tags));
+        }
+        if ( strlen($text) ) {
+            $text = trim($text);
+            $last = $text[strlen($text) - 1];
+            if ( $last != '.' && $trimmed ) {
+                $text .= $end;
+            }
+            if ( !$strip ) {
+                $last_p_tag = strrpos($text, '</p>');
+                if ( $last_p_tag !== false ) {
+                    $text = substr($text, 0, $last_p_tag);
+                }
+                if ( $last != '.' && $trimmed ) {
+                    $text .= $end . ' ';
+                }
+            }
+            $read_more_class = apply_filters('timber/post/get_preview/read_more_class', "read-more");
+            if ( $readmore && isset($readmore_matches) && !empty($readmore_matches[1]) ) {
+                $text .= ' <a href="' . $this->get_permalink() . '" class="'.$read_more_class .'">' . trim($readmore_matches[1]) . '</a>';
+            } elseif ( $readmore ) {
+                $text .= ' <a href="' . $this->get_permalink() . '" class="'.$read_more_class .'">' . trim($readmore) . '</a>';
+            }
+            if ( !$strip && $last_p_tag && ( strpos($text, '<p>') || strpos($text, '<p ') ) ) {
+                $text .= '</p>';
+            }
+        }
+        return trim($text);
+    }
+
+    /**
+     * gets the post custom and attaches it to the current object
+     * @internal
+     * @param bool|int $pid a post ID number
+     */
+    function import_custom( $pid = false ) {
+        if ( !$pid ) {
+            $pid = $this->ID;
+        }
+        $customs = $this->get_post_custom($pid);
+        $this->import($customs);
+    }
+
+    /**
+     * Used internally to fetch the metadata fields (wp_postmeta table)
+     * and attach them to our TimberPost object
+     * @internal
+     * @param int $pid
+     * @return array
+     */
+    protected function get_post_custom( $pid ) {
+        apply_filters('timber_post_get_meta_pre', array(), $pid, $this);
+        $customs = get_post_custom($pid);
+        if ( !is_array($customs) || empty($customs) ) {
+            return array();
+        }
+        foreach ( $customs as $key => $value ) {
+            if ( is_array($value) && count($value) == 1 && isset($value[0]) ) {
+                $value = $value[0];
+            }
+            $customs[$key] = maybe_unserialize($value);
+        }
+        $customs = apply_filters('timber_post_get_meta', $customs, $pid, $this);
+        return $customs;
+    }
+
+    /**
+     * @internal
+     * @see TimberPost::thumbnail
+     * @return null|TimberImage
+     */
+    function get_thumbnail() {
+        if ( function_exists('get_post_thumbnail_id') ) {
+            $tid = get_post_thumbnail_id($this->ID);
+            if ( $tid ) {
+                return new $this->ImageClass($tid);
+            }
+        }
+    }
+
+    /**
+     * @internal
+     * @see TimberPost::link
+     * @return string
+     */
+    function get_permalink() {
+        if ( isset($this->_permalink) ) {
+            return $this->_permalink;
+        }
+        $this->_permalink = get_permalink($this->ID);
+        return $this->_permalink;
+    }
+
+    /**
+     * get the permalink for a post object
+     * In your templates you should use link:
+     * <a href="{{post.link}}">Read my post</a>
+     * @internal
+     * @return string
+     */
+    function get_link() {
+        return $this->get_permalink();
+    }
+
+    /**
+     * Get the next post in WordPress's ordering
+     * @internal
+     * @param bool $taxonomy
+     * @return TimberPost|boolean
+     */
+    function get_next( $taxonomy = false ) {
+        if ( !isset($this->_next) || !isset($this->_next[$taxonomy]) ) {
+            global $post;
+            $this->_next = array();
+            $old_global = $post;
+            $post = $this;
+            if ( $taxonomy ) {
+                $adjacent = get_adjacent_post(true, '', false, $taxonomy);
+            } else {
+                $adjacent = get_adjacent_post(false, '', false);
+            }
+
+            if ( $adjacent ) {
+                $this->_next[$taxonomy] = new $this->PostClass($adjacent);
+            } else {
+                $this->_next[$taxonomy] = false;
+            }
+            $post = $old_global;
+        }
+        return $this->_next[$taxonomy];
+    }
+
+    /**
+     * Get a data array of pagination so you can navigate to the previous/next for a paginated post
+     * @return array
+     */
+    public function get_pagination() {
+        global $post, $page, $numpages, $multipage;
+        $post = $this;
+        $ret = array();
+        if ( $multipage ) {
+            for ( $i = 1; $i <= $numpages; $i++ ) {
+                $link = self::get_wp_link_page($i);
+                $data = array('name' => $i, 'title' => $i, 'text' => $i, 'link' => $link);
+                if ( $i == $page ) {
+                    $data['current'] = true;
+                }
+                $ret['pages'][] = $data;
+            }
+            $i = $page - 1;
+            if ( $i ) {
+                $link = self::get_wp_link_page($i);
+                $ret['prev'] = array('link' => $link);
+            }
+            $i = $page + 1;
+            if ( $i <= $numpages ) {
+                $link = self::get_wp_link_page($i);
+                $ret['next'] = array('link' => $link);
+            }
+        }
+        return $ret;
+    }
+
+    /**
+     * @param int $i
+     * @return string
+     */
+    protected static function get_wp_link_page($i) {
+        $link = _wp_link_page($i);
+        $link = new SimpleXMLElement($link . '</a>');
+        if ( isset($link['href']) ) {
+            return $link['href'];
+        }
+        return '';
+    }
+
+    /**
+     * Get the permalink for a post, but as a relative path
+     * For example, where {{post.link}} would return "http://example.org/2015/07/04/my-cool-post"
+     * this will return the relative version: "/2015/07/04/my-cool-post"
+     * @internal
+     * @return string
+     */
+    function get_path() {
+        return TimberURLHelper::get_rel_url($this->get_link());
+    }
+
+    /**
+     * Get the next post in WordPress's ordering
+     * @internal
+     * @param bool $taxonomy
+     * @return TimberPost|boolean
+     */
+    function get_prev( $taxonomy = false ) {
+        if ( isset($this->_prev) && isset($this->_prev[$taxonomy]) ) {
+            return $this->_prev[$taxonomy];
+        }
+        global $post;
+        $old_global = $post;
+        $post = $this;
+        $within_taxonomy = ($taxonomy) ? $taxonomy : 'category';
+        $adjacent = get_adjacent_post(($taxonomy), '', true, $within_taxonomy);
+        $prev_in_taxonomy = false;
+        if ( $adjacent ) {
+            $prev_in_taxonomy = new $this->PostClass($adjacent);
+        }
+        $this->_prev[$taxonomy] = $prev_in_taxonomy;
+        $post = $old_global;
+        return $this->_prev[$taxonomy];
+    }
+
+    /**
+     * Get the parent post of the post
+     * @internal
+     * @return bool|TimberPost
+     */
+    function get_parent() {
+        if ( !$this->post_parent ) {
+            return false;
+        }
+        return new $this->PostClass($this->post_parent);
+    }
+
+    /**
+     * Gets a User object from the author of the post
+     * @internal
+     * @see TimberPost::author
+     * @return bool|TimberUser
+     */
+    function get_author() {
+        if ( isset($this->post_author) ) {
+            return new TimberUser($this->post_author);
+        }
+    }
+
+    /**
+     * @internal
+     * @return bool|TimberUser
+     */
+    function get_modified_author() {
+        $user_id = get_post_meta($this->ID, '_edit_last', true);
+        return ($user_id ? new TimberUser($user_id) : $this->get_author());
+    }
+
+    /**
+     * Used internally by init, etc. to build TimberPost object
+     * @internal
+     * @param  int $pid
+     * @return null|object|WP_Post
+     */
+    protected function get_info($pid) {
+        $post = $this->prepare_post_info($pid);
+        if ( !isset($post->post_status) ) {
+            return null;
+        }
+        $post->status = $post->post_status;
+        $post->id = $post->ID;
+        $post->slug = $post->post_name;
+        $customs = $this->get_post_custom($post->ID);
+        $post->custom = $customs;
+        $post = (object) array_merge((array)$customs, (array)$post);
+        return $post;
+    }
+
+    /**
+     * @internal
+     * @see TimberPost::date
+     * @param  string $date_format
+     * @return string
+     */
+    function get_date( $date_format = '' ) {
+        $df = $date_format ? $date_format : get_option('date_format');
+        $the_date = (string)mysql2date($df, $this->post_date);
+        return apply_filters('get_the_date', $the_date, $df);
+    }
+
+    /**
+     * @internal
+     * @param  string $date_format
+     * @return string
+     */
+    function get_modified_date( $date_format = '' ) {
+        $df = $date_format ? $date_format : get_option('date_format');
+        $the_time = $this->get_modified_time($df);
+        return apply_filters('get_the_modified_date', $the_time, $date_format);
+    }
+
+    /**
+     * @internal
+     * @param  string $time_format
+     * @return string
+     */
+    function get_modified_time( $time_format = '' ) {
+        $tf = $time_format ? $time_format : get_option('time_format');
+        $the_time = get_post_modified_time($tf, false, $this->ID, true);
+        return apply_filters('get_the_modified_time', $the_time, $time_format);
+    }
+
+    /**
+     * @internal
+     * @see TimberPost::children
+     * @param string 		$post_type
+     * @param bool|string 	$childPostClass
+     * @return array
+     */
+    function get_children( $post_type = 'any', $childPostClass = false ) {
+        if ( $childPostClass === false ) {
+            $childPostClass = $this->PostClass;
+        }
+        if ( $post_type == 'parent' ) {
+            $post_type = $this->post_type;
+        }
+        $children = get_children('post_parent=' . $this->ID . '&post_type=' . $post_type . '&numberposts=-1&orderby=menu_order title&order=ASC&post_status=publish');
+        foreach ( $children as &$child ) {
+            $child = new $childPostClass($child->ID);
+        }
+        $children = array_values($children);
+        return $children;
+    }
+
+
+    /**
+     * Get the comments for a post
+     * @internal
+     * @see TimberPost::comments
+     * @param int $ct
+     * @param string $order
+     * @param string $type
+     * @param string $status
+     * @param string $CommentClass
+     * @return array|mixed
+     */
+
+    function get_comments($ct = 0, $order = 'wp', $type = 'comment', $status = 'approve', $CommentClass = 'TimberComment') {
+
+        global $overridden_cpage, $user_ID;
+        $overridden_cpage = false;
+
+        $commenter = wp_get_current_commenter();
+        $comment_author_email = $commenter['comment_author_email'];
+
+        $args = array('post_id' => $this->ID, 'status' => $status, 'order' => $order);
+        if ( $ct > 0 ) {
+            $args['number'] = $ct;
+        }
+        if ( strtolower($order) == 'wp' || strtolower($order) == 'wordpress' ) {
+            $args['order'] = get_option('comment_order');
+        }
+
+        if ( $user_ID ) {
+            $args['include_unapproved'] = array( $user_ID );
+        } elseif ( ! empty( $comment_author_email ) ) {
+            $args['include_unapproved'] = array( $comment_author_email );
+        }
+
+        $comments = get_comments($args);
+        $timber_comments = array();
+
+        if ( '' == get_query_var('cpage') && get_option('page_comments') ) {
+            set_query_var( 'cpage', 'newest' == get_option('default_comments_page') ? get_comment_pages_count() : 1 );
+            $overridden_cpage = true;
+        }
+
+        foreach($comments as $key => &$comment) {
+            $timber_comment = new $CommentClass($comment);
+            $timber_comments[$timber_comment->id] = $timber_comment;
+        }
+
+        // Build a flattened (depth=1) comment tree
+        $comments_tree = array();
+        foreach( $timber_comments as $key => $comment ) {
+            if ( ! $comment->is_child() ) {
+                continue;
+            }
+
+            $tree_element = $comment;
+            do {
+                $tree_element = $timber_comments[$tree_element->comment_parent];
+            } while( $tree_element->is_child() );
+
+            $comments_tree[$tree_element->id][] = $comment->id;
+        }
+
+        // Add child comments to the relative "super parents"
+        foreach($comments_tree as $comment_parent => $comment_children) {
+            foreach($comment_children as $comment_child) {
+                $timber_comments[$comment_parent]->children[] = $timber_comments[$comment_child];
+                unset($timber_comments[$comment_child]);
+            }
+        }
+
+        $timber_comments = array_values($timber_comments);
+
+        return $timber_comments;
+    }
+
+    /**
+     * Get the categories for a post
+     * @internal
+     * @see TimberPost::categories
+     * @return array of TimberTerms
+     */
+    function get_categories() {
+        return $this->get_terms('category');
+    }
+
+    /**
+     * @internal
+     * @see TimberPost::category
+     * @return mixed
+     */
+    function get_category( ) {
+        $cats = $this->get_categories();
+        if ( count($cats) && isset($cats[0]) ) {
+            return $cats[0];
+        }
+    }
+
+    /**
+     * @internal
+     * @param string|array $tax
+     * @param bool $merge
+     * @param string $TermClass
+     * @return array
+     */
+    function get_terms( $tax = '', $merge = true, $TermClass = '' ) {
+
+        $TermClass = $TermClass ?: $this->TermClass;
+
+        if ( is_string($merge) && class_exists($merge) ) {
+            $TermClass = $merge;
+        }
+        if ( is_array($tax) ) {
+            $taxonomies = $tax;
+        }
+        if ( is_string($tax) ) {
+            if ( in_array($tax, array('all','any','')) ) {
+                $taxonomies = get_object_taxonomies($this->post_type);
+            } else {
+                $taxonomies = array($tax);
+            }
+        }
+
+        $term_class_objects = array();
+
+        foreach ( $taxonomies as $taxonomy ) {
+            if ( in_array($taxonomy, array('tag','tags')) ) {
+                $taxonomy = 'post_tag';
+            }
+            if ( $taxonomy == 'categories' ) {
+                $taxonomy = 'category';
+            }
+
+            $terms = wp_get_post_terms($this->ID, $taxonomy);
+
+            if ( is_wp_error($terms) ) {
+                /* @var $terms WP_Error */
+                TimberHelper::error_log("Error retrieving terms for taxonomy '$taxonomy' on a post in timber-post.php");
+                TimberHelper::error_log('tax = ' . print_r($tax, true));
+                TimberHelper::error_log('WP_Error: ' . $terms->get_error_message());
+
+                return $term_class_objects;
+            }
+
+            // map over array of wordpress terms, and transform them into instances of the TermClass
+            $terms = array_map(function($term) use ($TermClass, $taxonomy) {
+                return call_user_func(array($TermClass, 'from'), $term->term_id, $taxonomy);
+            }, $terms);
+
+            if ( $merge && is_array($terms) ) {
+                $term_class_objects = array_merge($term_class_objects, $terms);
+            } else if ( count($terms) ) {
+                $term_class_objects[$taxonomy] = $terms;
+            }
+        }
+        return $term_class_objects;
+    }
+
+    /**
+     * @param string|int $term_name_or_id
+     * @param string $taxonomy
+     * @return bool
+     */
+    function has_term( $term_name_or_id, $taxonomy = 'all' ) {
+        if ( $taxonomy == 'all' || $taxonomy == 'any' ) {
+            $taxes = get_object_taxonomies($this->post_type, 'names');
+            $ret = false;
+            foreach ( $taxes as $tax ) {
+                if ( has_term($term_name_or_id, $tax, $this->ID) ) {
+                    $ret = true;
+                    break;
+                }
+            }
+            return $ret;
+        }
+        return has_term($term_name_or_id, $taxonomy, $this->ID);
+    }
+
+    /**
+     * @param string $field
+     * @return TimberImage
+     */
+    function get_image( $field ) {
+        return new $this->ImageClass($this->$field);
+    }
+
+    /**
+     * Gets an array of tags for you to use
+     * @internal
+     * @example
+     * ```twig
+     * <ul class="tags">
+     *     {% for tag in post.tags %}
+     *         <li>{{tag.name}}</li>
+     *     {% endfor %}
+     * </ul>
+     * ```
+     * @return array
+     */
+    function get_tags() {
+        return $this->get_terms('post_tag');
+    }
+
+    /**
+     * Outputs the title with filters applied
+     * @internal
+     * @example
+     * ```twig
+     * <h1>{{post.get_title}}</h1>
+     * ```
+     * ```html
+     * <h1>Hello World!</h1>
+     * ```
+     * @return string
+     */
+    function get_title() {
+        return apply_filters('the_title', $this->post_title, $this->ID);
+    }
+
+    /**
+     * Displays the content of the post with filters, shortcodes and wpautop applied
+     * @example
+     * ```twig
+     * <div class="article-text">{{post.get_content}}</div>
+     * ```
+     * ```html
+     * <div class="article-text"><p>Blah blah blah</p><p>More blah blah blah.</p></div>
+     * ```
+     * @param int $len
+     * @param int $page
+     * @return string
+     */
+    function get_content( $len = 0, $page = 0 ) {
+        if ( $len == 0 && $page == 0 && $this->_content ) {
+            return $this->_content;
+        }
+        $content = $this->post_content;
+        if ( $len ) {
+            $content = wp_trim_words($content, $len);
+        }
+        if ( $page ) {
+            $contents = explode('<!--nextpage-->', $content);
+            $page--;
+            if ( count($contents) > $page ) {
+                $content = $contents[$page];
+            }
+        }
+        $content = apply_filters('the_content', ($content));
+        if ( $len == 0 && $page == 0 ) {
+            $this->_content = $content;
+        }
+        return $content;
+    }
+
+    /**
+     * @return string
+     */
+    function get_paged_content() {
+        global $page;
+        return $this->get_content(0, $page);
+    }
+    /**
+     *
+     * Here is my summary
+     * @example
+     * ```twig
+     * This post is from <span>{{ post.get_post_type.labels.plural }}</span>
+     * ```
+     *
+     * ```html
+     * This post is from <span>Recipes</span>
+     * ```
+     * @return mixed
+     */
+    public function get_post_type() {
+        return get_post_type_object($this->post_type);
+    }
+
+    /**
+     * @return int the number of comments on a post
+     */
+    public function get_comment_count() {
+        return get_comments_number($this->ID);
+    }
+
+    /**
+     * @param string $field_name
+     * @return mixed
+     */
+    public function get_field( $field_name ) {
+        $value = apply_filters('timber_post_get_meta_field_pre', null, $this->ID, $field_name, $this);
+        if ( $value === null ) {
+            $value = get_post_meta($this->ID, $field_name);
+            if ( is_array($value) && count($value) == 1 ) {
+                $value = $value[0];
+            }
+            if ( is_array($value) && count($value) == 0 ) {
+                $value = null;
+            }
+        }
+        $value = apply_filters('timber_post_get_meta_field', $value, $this->ID, $field_name, $this);
+        return $value;
+    }
+
+    /**
+     * @param string $field_name
+     */
+    function import_field( $field_name ) {
+        $this->$field_name = $this->get_field($field_name);
+    }
+
+    /**
+     * @internal
+     * @return mixed
+     */
+    function get_format() {
+        return get_post_format($this->ID);
+    }
+
+    /**
+     * Get the CSS classes for a post. For usage you should use `{{post.class}}` instead of `{{post.post_class}}`
+     * @internal
+     * @param string $class additional classes you want to add
+     * @see TimberPost::$class
+     * @example
+     * ```twig
+     * <article class="{{ post.class }}">
+     *    {# Some stuff here #}
+     * </article>
+     * ```
+     *
+     * ```html
+     * <article class="post-2612 post type-post status-publish format-standard has-post-thumbnail hentry category-data tag-charleston-church-shooting tag-dylann-roof tag-gun-violence tag-hate-crimes tag-national-incident-based-reporting-system">
+     *    {# Some stuff here #}
+     * </article>
+     * ```
+     * @return string a space-seperated list of classes
+     */
+    public function post_class( $class='' ) {
+        global $post;
+        $old_global_post = $post;
+        $post = $this;
+        $class_array = get_post_class($class, $this->ID);
+        $post = $old_global_post;
+        if ( is_array($class_array) ){
+            return implode(' ', $class_array);
+        }
+        return $class_array;
+    }
+
+    // Docs
+
+    /**
+     * @return array
+     * @codeCoverageIgnore
+     */
+    public function get_method_values() {
+        $ret = parent::get_method_values();
+        $ret['author'] = $this->author();
+        $ret['categories'] = $this->categories();
+        $ret['category'] = $this->category();
+        $ret['children'] = $this->children();
+        $ret['comments'] = $this->comments();
+        $ret['content'] = $this->content();
+        $ret['edit_link'] = $this->edit_link();
+        $ret['format'] = $this->format();
+        $ret['link'] = $this->link();
+        $ret['next'] = $this->next();
+        $ret['pagination'] = $this->pagination();
+        $ret['parent'] = $this->parent();
+        $ret['path'] = $this->path();
+        $ret['prev'] = $this->prev();
+        $ret['terms'] = $this->terms();
+        $ret['tags'] = $this->tags();
+        $ret['thumbnail'] = $this->thumbnail();
+        $ret['title'] = $this->title();
+        return $ret;
+    }
+
+    /**
+     * Return the author of a post
+     * @api
+     * @example
+     * ```twig
+     * <h1>{{post.title}}</h1>
+     * <p class="byline">
+     *     <a href="{{post.author.link}}">{{post.author.name}}</a>
+     * </p>
+     * ```
+     * @return TimberUser|bool A TimberUser object if found, false if not
+     */
+    public function author() {
+        return $this->get_author();
+    }
+
+    /**
+     * Get the author (WordPress user) who last modified the post
+     * @example
+     * ```twig
+     * Last updated by {{ post.modified_author.name }}
+     * ```
+     * ```html
+     * Last updated by Harper Lee
+     * ```
+     * @return TimberUser|bool A TimberUser object if found, false if not
+     */
+    public function modified_author() {
+        return $this->get_modified_author();
+    }
+
+    /**
+     * Get the categoires on a particular post
+     * @api
+     * @return array of TimberTerms
+     */
+    public function categories() {
+        return $this->get_terms('category');
+    }
+
+    /**
+     * Returns a category attached to a post
+     * @api
+     * If mulitpuile categories are set, it will return just the first one
+     * @return TimberTerm|null
+     */
+    public function category() {
+        return $this->get_category();
+    }
+
+    /**
+     * Returns an array of children on the post as TimberPosts
+     * (or other claass as you define).
+     * @api
+     * @example
+     * ```twig
+     * {% if post.children %}
+     *     Here are the child pages:
+     *     {% for child in page.children %}
+     *         <a href="{{ child.link }}">{{ child.title }}</a>
+     *     {% endfor %}
+     * {% endif %}
+     * ```
+     * @param string $post_type _optional_ use to find children of a particular post type (attachment vs. page for example). You might want to restrict to certain types of children in case other stuff gets all mucked in there. You can use 'parent' to use the parent's post type
+     * @param string|bool $childPostClass _optional_ a custom post class (ex: 'MyTimberPost') to return the objects as. By default (false) it will use TimberPost::$post_class value.
+     * @return array
+     */
+    public function children( $post_type = 'any', $childPostClass = false ) {
+        return $this->get_children( $post_type, $childPostClass );
+    }
+
+    /**
+     * Gets the comments on a TimberPost and returns them as an array of [TimberComments](#TimberComment) (or whatever comment class you set).
+     * @api
+     * @param int $count Set the number of comments you want to get. `0` is analogous to "all"
+     * @param string $order use ordering set in WordPress admin, or a different scheme
+     * @param string $type For when other plugins use the comments table for their own special purposes, might be set to 'liveblog' or other depending on what's stored in yr comments table
+     * @param string $status Could be 'pending', etc.
+     * @param string $CommentClass What class to use when returning Comment objects. As you become a Timber pro, you might find yourself extending TimberComment for your site or app (obviously, totally optional)
+     * @example
+     * ```twig
+     * {# single.twig #}
+     * <h4>Comments:</h4>
+     * {% for comment in post.comments %}
+     * 	<div class="comment-{{comment.ID}} comment-order-{{loop.index}}">
+     * 		<p>{{comment.author.name}} said:</p>
+     * 		<p>{{comment.content}}</p>
+     * 	</div>
+     * {% endfor %}
+     * ```
+     * @return bool|array
+     */
+    public function comments( $count = 0, $order = 'wp', $type = 'comment', $status = 'approve', $CommentClass = 'TimberComment' ) {
+        return $this->get_comments($count, $order, $type, $status, $CommentClass);
+    }
+
+    /**
+     * Gets the actual content of a WP Post, as opposed to post_content this will run the hooks/filters attached to the_content. \This guy will return your posts content with WordPress filters run on it (like for shortcodes and wpautop).
+     * @api
+     * @example
+     * ```twig
+     * <div class="article">
+     *     <h2>{{post.title}}</h2>
+     *     <div class="content">{{ post.content }}</div>
+     * </div>
+     * ```
+     * @param int $page
+     * @return string
+     */
+    public function content( $page = 0 ) {
+        return $this->get_content(0, $page);
+    }
+
+    /**
+     * @return string
+     */
+    public function paged_content() {
+        return $this->get_paged_content();
+    }
+
+    /**
+     * Get the date to use in your template!
+     * @api
+     * @example
+     * ```twig
+     * Published on {{ post.date }} // Uses WP's formatting set in Admin
+     * OR
+     * Published on {{ post.date | date('F jS') }} // Jan 12th
+     * ```
+     *
+     * ```html
+     * Published on January 12, 2015
+     * OR
+     * Published on Jan 12th
+     * ```
+     * @param string $date_format
+     * @return string
+     */
+    public function date( $date_format = '' ) {
+        return $this->get_date($date_format);
+    }
+
+    /**
+     * Get the time to use in your template
+     * @api
+     * @example
+     * ```twig
+     * Published at {{ post.time }} // Uses WP's formatting set in Admin
+     * OR
+     * Published at {{ post.time | time('G:i') }} // 13:25
+     * ```
+     *
+     * ```html
+     * Published at 1:25 pm
+     * OR
+     * Published at 13:25
+     * ```
+     * @param string $time_format
+     * @return string
+     */
+    public function time( $time_format = '' ) {
+        $tf = $time_format ? $time_format : get_option('time_format');
+            $the_time = (string)mysql2date($tf, $this->post_date);
+            return apply_filters('get_the_time', $the_time, $tf);
+    }
+
+    /**
+     * @return bool|string
+     */
+    public function edit_link() {
+        return $this->get_edit_url();
+    }
+
+    /**
+     * @api
+     * @return mixed
+     */
+    public function format() {
+        return $this->get_format();
+    }
+
+    /**
+     * get the permalink for a post object
+     * @api
+     * @example
+     * ```twig
+     * <a href="{{post.link}}">Read my post</a>
+     * ```
+     * @return string ex: http://example.org/2015/07/my-awesome-post
+     */
+    public function link() {
+        return $this->get_permalink();
+    }
+
+    /**
+     * @param string $field_name
+     * @return mixed
+     */
+    public function meta( $field_name = null ) {
+        if ( $field_name === null ) {
+            //on the off-chance the field is actually named meta
+            $field_name = 'meta';
+        }
+        return $this->get_field($field_name);
+    }
+
+    /**
+     * @return string
+     */
+    public function name(){
+        return $this->title();
+    }
+
+    /**
+     * @param string $date_format
+     * @return string
+     */
+    public function modified_date( $date_format = '' ) {
+        return $this->get_modified_date($date_format);
+    }
+
+    /**
+     * @param string $time_format
+     * @return string
+     */
+    public function modified_time( $time_format = '' ) {
+        return $this->get_modified_time($time_format);
+    }
+
+    /**
+     * @api
+     * @param bool $in_same_cat
+     * @return mixed
+     */
+    public function next( $in_same_cat = false ) {
+        return $this->get_next($in_same_cat);
+    }
+
+    /**
+     * @return array
+     */
+    public function pagination() {
+        return $this->get_pagination();
+    }
+
+    /**
+     * Gets the parent (if one exists) from a post as a TimberPost object (or whatever is set in TimberPost::$PostClass)
+     * @api
+     * @example
+     * ```twig
+     * Parent page: <a href="{{ post.parent.link }}">{{ post.parent.title }}</a>
+     * ```
+     * @return bool|TimberPost
+     */
+    public function parent() {
+        return $this->get_parent();
+    }
+
+    /**
+     * Gets the relative path of a WP Post, so while link() will return http://example.org/2015/07/my-cool-post
+     * this will return just /2015/07/my-cool-post
+     * @api
+     * @example
+     * ```twig
+     * <a href="{{post.path}}">{{post.title}}</a>
+     * ```
+     * @return string
+     */
+    public function path() {
+        return $this->get_path();
+    }
+
+    /**
+     * @deprecated 0.20.0 use link() instead
+     * @return string
+     */
+    public function permalink() {
+        return $this->get_permalink();
+    }
+
+    /**
+     * Get the previous post in a set
+     * @api
+     * @example
+     * ```twig
+     * <h4>Prior Entry:</h4>
+     * <h3>{{post.prev.title}}</h3>
+     * <p>{{post.prev.get_preview(25)}}</p>
+     * ```
+     * @param bool $in_same_cat
+     * @return mixed
+     */
+    public function prev( $in_same_cat = false ) {
+        return $this->get_prev($in_same_cat);
+    }
+
+    /**
+     * Get the terms associated with the post
+     * This goes across all taxonomies by default
+     * @api
+     * @param string|array $tax What taxonom(y|ies) to pull from. Defaults to all registered taxonomies for the post type. You can use custom ones, or built-in WordPress taxonomies (category, tag). Timber plays nice and figures out that tag/tags/post_tag are all the same (and categories/category), for custom taxonomies you're on your own.
+     * @param bool $merge Should the resulting array be one big one (true)? Or should it be an array of sub-arrays for each taxonomy (false)?
+     * @return array
+     */
+    public function terms( $tax = '', $merge = true ) {
+        return $this->get_terms($tax, $merge);
+    }
+
+    /**
+     * Gets the tags on a post, uses WP's post_tag taxonomy
+     * @api
+     * @return array
+     */
+    public function tags() {
+        return $this->get_tags();
+    }
+
+    /**
+     * get the featured image as a TimberImage
+     * @api
+     * @example
+     * ```twig
+     * <img src="{{post.thumbnail.src}}" />
+     * ```
+     * @return TimberImage|null of your thumbnail
+     */
+    public function thumbnail() {
+        return $this->get_thumbnail();
+    }
+
+    /**
+     * Returns the processed title to be used in templates. This returns the title of the post after WP's filters have run. This is analogous to `the_title()` in standard WP template tags.
+     * @api
+     * @example
+     * ```twig
+     * <h1>{{ post.title }}</h1>
+     * ```
+     * @return string
+     */
+    public function title() {
+        return $this->get_title();
+    }
 
 }

lib/timber-core-interface.php

Indentation +7 added lines, -7 removed lines

@@ -2,15 +2,15 @@
 
 interface TimberCoreInterface {
 
-	public function __call( $field, $args );
+    public function __call( $field, $args );
 
-	public function __get( $field );
+    public function __get( $field );
 
-	/**
-	 * @return boolean
-	 */
-	public function __isset( $field );
+    /**
+     * @return boolean
+     */
+    public function __isset( $field );
 
-	public function meta( $key );
+    public function meta( $key );
 
 }

lib/timber-function-wrapper.php

Indentation +73 added lines, -73 removed lines

@@ -2,91 +2,91 @@
 
 class TimberFunctionWrapper {
 
-	private $_class;
-	private $_function;
-	private $_args;
-	private $_use_ob;
+    private $_class;
+    private $_function;
+    private $_args;
+    private $_use_ob;
 
-	public function __toString() {
-		 try {
-			return (string)$this->call();
-		 } catch (Exception $e) {
-		 	return 'Caught exception: ' . $e->getMessage() . "\n";
-		 }
-	}
+    public function __toString() {
+            try {
+            return (string)$this->call();
+            } catch (Exception $e) {
+                return 'Caught exception: ' . $e->getMessage() . "\n";
+            }
+    }
 
-	/**
-	 *
-	 *
-	 * @param callable $function
-	 * @param array   $args
-	 * @param bool    $return_output_buffer
-	 */
-	public function __construct( $function, $args = array(), $return_output_buffer = false ) {
-		if( is_array( $function ) ) {
-			if( (is_string( $function[0] ) && class_exists( $function[0] ) ) || gettype( $function[0] ) === 'object' ) {
-				$this->_class = $function[0];
-			}
+    /**
+     *
+     *
+     * @param callable $function
+     * @param array   $args
+     * @param bool    $return_output_buffer
+     */
+    public function __construct( $function, $args = array(), $return_output_buffer = false ) {
+        if( is_array( $function ) ) {
+            if( (is_string( $function[0] ) && class_exists( $function[0] ) ) || gettype( $function[0] ) === 'object' ) {
+                $this->_class = $function[0];
+            }
 			
-			if( is_string( $function[1] ) ) $this->_function = $function[1];
-		} else {
-			$this->_function = $function;
-		}
+            if( is_string( $function[1] ) ) $this->_function = $function[1];
+        } else {
+            $this->_function = $function;
+        }
 
-		$this->_args = $args;
-		$this->_use_ob = $return_output_buffer;
+        $this->_args = $args;
+        $this->_use_ob = $return_output_buffer;
 
-		add_filter( 'get_twig', array( &$this, 'add_to_twig' ) );
-	}
+        add_filter( 'get_twig', array( &$this, 'add_to_twig' ) );
+    }
 
-	/**
-	 *
-	 *
-	 * @param Twig_Environment $twig
-	 * @return Twig_Environment
-	 */
-	public function add_to_twig( $twig ) {
-		$wrapper = $this;
+    /**
+     *
+     *
+     * @param Twig_Environment $twig
+     * @return Twig_Environment
+     */
+    public function add_to_twig( $twig ) {
+        $wrapper = $this;
 
-		$twig->addFunction( new Twig_SimpleFunction( $this->_function, function () use ( $wrapper ) {
-					return call_user_func_array( array( $wrapper, 'call' ), func_get_args() );
-				} ) );
+        $twig->addFunction( new Twig_SimpleFunction( $this->_function, function () use ( $wrapper ) {
+                    return call_user_func_array( array( $wrapper, 'call' ), func_get_args() );
+                } ) );
 
-		return $twig;
-	}
+        return $twig;
+    }
 
-	/**
-	 *
-	 *
-	 * @return string
-	 */
-	public function call() {
-		$args = $this->_parse_args( func_get_args(), $this->_args );
-		$callable = ( isset( $this->_class ) ) ? array( $this->_class, $this->_function ) : $this->_function;
+    /**
+     *
+     *
+     * @return string
+     */
+    public function call() {
+        $args = $this->_parse_args( func_get_args(), $this->_args );
+        $callable = ( isset( $this->_class ) ) ? array( $this->_class, $this->_function ) : $this->_function;
 
-		if ( $this->_use_ob ) {
-			return TimberHelper::ob_function( $callable, $args );
-		} else {
-			return call_user_func_array( $callable, $args );
-		}
-	}
+        if ( $this->_use_ob ) {
+            return TimberHelper::ob_function( $callable, $args );
+        } else {
+            return call_user_func_array( $callable, $args );
+        }
+    }
 
-	/**
-	 *
-	 *
-	 * @param array   $args
-	 * @param array   $defaults
-	 * @return array
-	 */
-	private function _parse_args( $args, $defaults ) {
-		$_arg = reset( $defaults );
+    /**
+     *
+     *
+     * @param array   $args
+     * @param array   $defaults
+     * @return array
+     */
+    private function _parse_args( $args, $defaults ) {
+        $_arg = reset( $defaults );
 
-		foreach ( $args as $index => $arg ) {
-			$defaults[$index] = is_null( $arg ) ? $_arg : $arg;
-			$_arg = next( $defaults );
-		}
+        foreach ( $args as $index => $arg ) {
+            $defaults[$index] = is_null( $arg ) ? $_arg : $arg;
+            $_arg = next( $defaults );
+        }
 
-		return $defaults;
-	}
+        return $defaults;
+    }
 
 }

lib/timber-term-getter.php

Indentation +167 added lines, -167 removed lines

@@ -2,180 +2,180 @@
 
 class TimberTermGetter {
 
-	/**
-	 * @param string|array $args
-	 * @param array $maybe_args
-	 * @param string $TermClass
-	 * @return mixed
-	 */
-	public static function get_terms($args = null, $maybe_args = array(), $TermClass = 'TimberTerm') {
-		if ( is_string($maybe_args) && !strstr($maybe_args, '=') ) {
-			//the user is sending the $TermClass in the second argument
-			$TermClass = $maybe_args;
-		}
-		if ( is_string($maybe_args) && strstr($maybe_args, '=') ) {
-			parse_str($maybe_args, $maybe_args);
-		}
-		if ( is_string($args) && strstr($args, '=') ) {
-			//a string and a query string!
-			$parsed = self::get_term_query_from_query_string($args);
-			if ( is_array($maybe_args) ) {
-				$parsed->args = array_merge($parsed->args, $maybe_args);
-			}
-			return self::handle_term_query($parsed->taxonomies, $parsed->args, $TermClass);
-		} else if ( is_string($args) ) {
-			//its just a string with a single taxonomy
-			$parsed = self::get_term_query_from_string($args);
-			if ( is_array($maybe_args) ) {
-				$parsed->args = array_merge($parsed->args, $maybe_args);
-			}
-			return self::handle_term_query($parsed->taxonomies, $parsed->args, $TermClass);
-		} else if ( is_array($args) && TimberHelper::is_array_assoc($args) ) {
-			//its an associative array, like a good ole query
-			$parsed = self::get_term_query_from_assoc_array($args);
-			return self::handle_term_query($parsed->taxonomies, $parsed->args, $TermClass);
-		} else if ( is_array($args) ) {
-			//its just an array of strings or IDs (hopefully)
-			$parsed = self::get_term_query_from_array($args);
-			if ( is_array($maybe_args) ) {
-				$parsed->args = array_merge($parsed->args, $maybe_args);
-			}
-			return self::handle_term_query($parsed->taxonomies, $parsed->args, $TermClass);
-		} else if ( is_null($args) ) {
-			return self::handle_term_query(get_taxonomies(), array(), $TermClass);
-		}
-		return null;
-	}
+    /**
+     * @param string|array $args
+     * @param array $maybe_args
+     * @param string $TermClass
+     * @return mixed
+     */
+    public static function get_terms($args = null, $maybe_args = array(), $TermClass = 'TimberTerm') {
+        if ( is_string($maybe_args) && !strstr($maybe_args, '=') ) {
+            //the user is sending the $TermClass in the second argument
+            $TermClass = $maybe_args;
+        }
+        if ( is_string($maybe_args) && strstr($maybe_args, '=') ) {
+            parse_str($maybe_args, $maybe_args);
+        }
+        if ( is_string($args) && strstr($args, '=') ) {
+            //a string and a query string!
+            $parsed = self::get_term_query_from_query_string($args);
+            if ( is_array($maybe_args) ) {
+                $parsed->args = array_merge($parsed->args, $maybe_args);
+            }
+            return self::handle_term_query($parsed->taxonomies, $parsed->args, $TermClass);
+        } else if ( is_string($args) ) {
+            //its just a string with a single taxonomy
+            $parsed = self::get_term_query_from_string($args);
+            if ( is_array($maybe_args) ) {
+                $parsed->args = array_merge($parsed->args, $maybe_args);
+            }
+            return self::handle_term_query($parsed->taxonomies, $parsed->args, $TermClass);
+        } else if ( is_array($args) && TimberHelper::is_array_assoc($args) ) {
+            //its an associative array, like a good ole query
+            $parsed = self::get_term_query_from_assoc_array($args);
+            return self::handle_term_query($parsed->taxonomies, $parsed->args, $TermClass);
+        } else if ( is_array($args) ) {
+            //its just an array of strings or IDs (hopefully)
+            $parsed = self::get_term_query_from_array($args);
+            if ( is_array($maybe_args) ) {
+                $parsed->args = array_merge($parsed->args, $maybe_args);
+            }
+            return self::handle_term_query($parsed->taxonomies, $parsed->args, $TermClass);
+        } else if ( is_null($args) ) {
+            return self::handle_term_query(get_taxonomies(), array(), $TermClass);
+        }
+        return null;
+    }
 
-	/**
-	 * @param string|array $taxonomies
-	 * @param string|array $args
-	 * @param string $TermClass
-	 * @return mixed
-	 */
-	public static function handle_term_query($taxonomies, $args, $TermClass) {
-		if ( !isset($args['hide_empty']) ) {
-			$args['hide_empty'] = false;
-		}
-		if ( isset($args['term_id']) && is_int($args['term_id']) ) {
-			$args['term_id'] = array($args['term_id']);
-		}
-		if ( isset($args['term_id']) ) {
-			$args['include'] = $args['term_id'];
-		}
-		$terms = get_terms($taxonomies, $args);
-		foreach ($terms as &$term) {
-			$term = new $TermClass($term->term_id, $term->taxonomy);
-		}
-		return $terms;
-	}
+    /**
+     * @param string|array $taxonomies
+     * @param string|array $args
+     * @param string $TermClass
+     * @return mixed
+     */
+    public static function handle_term_query($taxonomies, $args, $TermClass) {
+        if ( !isset($args['hide_empty']) ) {
+            $args['hide_empty'] = false;
+        }
+        if ( isset($args['term_id']) && is_int($args['term_id']) ) {
+            $args['term_id'] = array($args['term_id']);
+        }
+        if ( isset($args['term_id']) ) {
+            $args['include'] = $args['term_id'];
+        }
+        $terms = get_terms($taxonomies, $args);
+        foreach ($terms as &$term) {
+            $term = new $TermClass($term->term_id, $term->taxonomy);
+        }
+        return $terms;
+    }
 
-	/**
-	 * @param string $query_string
-	 * @return stdClass
-	 */
-	protected static function get_term_query_from_query_string($query_string) {
-		$args = array();
-		parse_str($query_string, $args);
-		$ret = self::get_term_query_from_assoc_array($args);
-		return $ret;
-	}
+    /**
+     * @param string $query_string
+     * @return stdClass
+     */
+    protected static function get_term_query_from_query_string($query_string) {
+        $args = array();
+        parse_str($query_string, $args);
+        $ret = self::get_term_query_from_assoc_array($args);
+        return $ret;
+    }
 
-	/**
-	 * @param string $taxs
-	 * @return stdClass
-	 */
-	protected static function get_term_query_from_string($taxs) {
-		$ret = new stdClass();
-		$ret->args = array();
-		if ( is_string($taxs) ) {
-			$taxs = array($taxs);
-		}
-		$ret->taxonomies = self::correct_taxonomy_names($taxs);
-		return $ret;
-	}
+    /**
+     * @param string $taxs
+     * @return stdClass
+     */
+    protected static function get_term_query_from_string($taxs) {
+        $ret = new stdClass();
+        $ret->args = array();
+        if ( is_string($taxs) ) {
+            $taxs = array($taxs);
+        }
+        $ret->taxonomies = self::correct_taxonomy_names($taxs);
+        return $ret;
+    }
 
-	/**
-	 * @param array $args
-	 * @return stdClass
-	 */
-	public static function get_term_query_from_assoc_array($args) {
-		$ret = new stdClass();
-		$ret->args = $args;
-		if ( isset($ret->args['tax']) ) {
-			$ret->taxonomies = $ret->args['tax'];
-		} else if ( isset($ret->args['taxonomies']) ) {
-			$ret->taxonomies = $ret->args['taxonomies'];
-		} else if ( isset($ret->args['taxs']) ) {
-			$ret->taxonomies = $ret->args['taxs'];
-		} else if ( isset($ret->args['taxonomy']) ) {
-			$ret->taxonomies = $ret->args['taxonomy'];
-		}
-		if ( isset($ret->taxonomies) ) {
-			if ( is_string($ret->taxonomies) ) {
-				$ret->taxonomies = array($ret->taxonomies);
-			}
-			$ret->taxonomies = self::correct_taxonomy_names($ret->taxonomies);
-		} else {
-			$ret->taxonomies = get_taxonomies();
-		}
-		return $ret;
-	}
+    /**
+     * @param array $args
+     * @return stdClass
+     */
+    public static function get_term_query_from_assoc_array($args) {
+        $ret = new stdClass();
+        $ret->args = $args;
+        if ( isset($ret->args['tax']) ) {
+            $ret->taxonomies = $ret->args['tax'];
+        } else if ( isset($ret->args['taxonomies']) ) {
+            $ret->taxonomies = $ret->args['taxonomies'];
+        } else if ( isset($ret->args['taxs']) ) {
+            $ret->taxonomies = $ret->args['taxs'];
+        } else if ( isset($ret->args['taxonomy']) ) {
+            $ret->taxonomies = $ret->args['taxonomy'];
+        }
+        if ( isset($ret->taxonomies) ) {
+            if ( is_string($ret->taxonomies) ) {
+                $ret->taxonomies = array($ret->taxonomies);
+            }
+            $ret->taxonomies = self::correct_taxonomy_names($ret->taxonomies);
+        } else {
+            $ret->taxonomies = get_taxonomies();
+        }
+        return $ret;
+    }
 
-	/**
-	 * @param array $args
-	 * @return stdClass
-	 */
-	public static function get_term_query_from_array($args) {
-		if ( is_array($args) && !empty($args) ) {
-			//okay its an array with content
-			if ( is_int($args[0]) ) {
-				return self::get_term_query_from_array_of_ids($args);
-			} else if ( is_string($args[0]) ) {
-				return self::get_term_query_from_array_of_strings($args);
-			}
-		}
-		return null;
-	}
+    /**
+     * @param array $args
+     * @return stdClass
+     */
+    public static function get_term_query_from_array($args) {
+        if ( is_array($args) && !empty($args) ) {
+            //okay its an array with content
+            if ( is_int($args[0]) ) {
+                return self::get_term_query_from_array_of_ids($args);
+            } else if ( is_string($args[0]) ) {
+                return self::get_term_query_from_array_of_strings($args);
+            }
+        }
+        return null;
+    }
 
-	/**
-	 * @param integer[] $args
-	 * @return stdClass
-	 */
-	public static function get_term_query_from_array_of_ids($args) {
-		$ret = new stdClass();
-		$ret->taxonomies = get_taxonomies();
-		$ret->args['include'] = $args;
-		return $ret;
-	}
+    /**
+     * @param integer[] $args
+     * @return stdClass
+     */
+    public static function get_term_query_from_array_of_ids($args) {
+        $ret = new stdClass();
+        $ret->taxonomies = get_taxonomies();
+        $ret->args['include'] = $args;
+        return $ret;
+    }
 
-	/**
-	 * @param string[] $args
-	 * @return stdClass
-	 */
-	public static function get_term_query_from_array_of_strings($args) {
-		$ret = new stdClass();
-		$ret->taxonomies = self::correct_taxonomy_names($args);
-		$ret->args = array();
-		return $ret;
-	}
+    /**
+     * @param string[] $args
+     * @return stdClass
+     */
+    public static function get_term_query_from_array_of_strings($args) {
+        $ret = new stdClass();
+        $ret->taxonomies = self::correct_taxonomy_names($args);
+        $ret->args = array();
+        return $ret;
+    }
 
-	/**
-	 * @param string|array $taxs
-	 * @return array
-	 */
-	private static function correct_taxonomy_names($taxs) {
-		if ( is_string($taxs) ) {
-			$taxs = array($taxs);
-		}
-		foreach ($taxs as &$tax) {
-			if ( $tax == 'tags' || $tax == 'tag' ) {
-				$tax = 'post_tag';
-			} else if ( $tax == 'categories' ) {
-				$tax = 'category';
-			}
-		}
-		return $taxs;
-	}
+    /**
+     * @param string|array $taxs
+     * @return array
+     */
+    private static function correct_taxonomy_names($taxs) {
+        if ( is_string($taxs) ) {
+            $taxs = array($taxs);
+        }
+        foreach ($taxs as &$tax) {
+            if ( $tax == 'tags' || $tax == 'tag' ) {
+                $tax = 'post_tag';
+            } else if ( $tax == 'categories' ) {
+                $tax = 'category';
+            }
+        }
+        return $taxs;
+    }
 
 }

lib/timber-loader.php

Indentation +407 added lines, -407 removed lines

@@ -2,412 +2,412 @@
 
 class TimberLoader {
 
-	const CACHEGROUP = 'timberloader';
-
-	const TRANS_KEY_LEN = 50;
-
-	const CACHE_NONE = 'none';
-	const CACHE_OBJECT = 'cache';
-	const CACHE_TRANSIENT = 'transient';
-	const CACHE_SITE_TRANSIENT = 'site-transient';
-	const CACHE_USE_DEFAULT = 'default';
-
-	public static $cache_modes = array(
-		self::CACHE_NONE,
-		self::CACHE_OBJECT,
-		self::CACHE_TRANSIENT,
-		self::CACHE_SITE_TRANSIENT
-	);
-
-	protected $cache_mode = self::CACHE_TRANSIENT;
-
-	public $locations;
-
-	/**
-	 * @param bool|string   $caller the calling directory or false
-	 */
-	function __construct($caller = false) {
-		$this->locations = $this->get_locations($caller);
-		$this->cache_mode = apply_filters('timber_cache_mode', $this->cache_mode);
-		$this->cache_mode = apply_filters('timber/cache/mode', $this->cache_mode);
-	}
-
-	/**
-	 * @param string        $file
-	 * @param array         $data
-	 * @param bool          $expires
-	 * @param string        $cache_mode
-	 * @return bool|string
-	 */
-	function render($file, $data = null, $expires = false, $cache_mode = self::CACHE_USE_DEFAULT) {
-		// Different $expires if user is anonymous or logged in
-		if (is_array($expires)) {
-			if (is_user_logged_in() && isset($expires[1])) {
-				$expires = $expires[1];
-			} else {
-				$expires = $expires[0];
-			}
-		}
-
-		$key = null;
-		$output = false;
-		if (false !== $expires) {
-			ksort($data);
-			$key = md5($file . json_encode($data));
-			$output = $this->get_cache($key, self::CACHEGROUP, $cache_mode);
-		}
-
-		if (false === $output || null === $output) {
-			$twig = $this->get_twig();
-			if (strlen($file)) {
-				$loader = $this->get_loader();
-				$result = $loader->getCacheKey($file);
-				do_action('timber_loader_render_file', $result);
-			}
-			$data = apply_filters('timber_loader_render_data', $data);
-			$data = apply_filters('timber/loader/render_data', $data);
-			$output = $twig->render($file, $data);
-		}
-
-		if (false !== $output && false !== $expires && null !== $key) {
-			$this->set_cache($key, $output, self::CACHEGROUP, $expires, $cache_mode);
-		}
-		$output = apply_filters('timber_output', $output);
-		return apply_filters('timber/output', $output);
-	}
-
-	/**
-	 * @param array $filenames
-	 * @return bool
-	 */
-	public function choose_template($filenames) {
-		if (is_array($filenames)) {
-			/* its an array so we have to figure out which one the dev wants */
-			foreach ($filenames as $filename) {
-				if (self::template_exists($filename)) {
-					return $filename;
-				}
-			}
-			return $filenames[0];
-		}
-		return $filenames;
-	}
-
-	/**
-	 * @param string $file
-	 * @return bool
-	 */
-	protected function template_exists($file) {
-		foreach ($this->locations as $dir) {
-			$look_for = trailingslashit($dir) . $file;
-			if (file_exists($look_for)) {
-				return true;
-			}
-		}
-		return false;
-	}
-
-	/**
-	 * @return array
-	 */
-	function get_locations_theme() {
-		$theme_locs = array();
-		$child_loc = get_stylesheet_directory();
-		$parent_loc = get_template_directory();
-		if (DIRECTORY_SEPARATOR == '\\') {
-			$child_loc = str_replace('/', '\\', $child_loc);
-			$parent_loc = str_replace('/', '\\', $parent_loc);
-		}
-		$theme_locs[] = $child_loc;
-		foreach ($this->get_locations_theme_dir() as $dirname) {
-			$theme_locs[] = trailingslashit($child_loc) . trailingslashit($dirname);
-		}
-		if ($child_loc != $parent_loc) {
-			$theme_locs[] = $parent_loc;
-			foreach ($this->get_locations_theme_dir() as $dirname) {
-				$theme_locs[] = trailingslashit($parent_loc) . trailingslashit($dirname);
-			}
-		}
-		//now make sure theres a trailing slash on everything
-		$theme_locs = array_map('trailingslashit', $theme_locs);
-		return $theme_locs;
-	}
-
-	/**
-	 * returns an array of the directory inside themes that holds twig files
-	 * @return string[] the names of directores, ie: array('templats', 'views');
-	 */
-	private function get_locations_theme_dir() {
-		if (is_string(Timber::$dirname)) {
-			return array(Timber::$dirname);
-		}
-		return Timber::$dirname;
-	}
-
-	/**
-	 * @return array
-	 */
-	function get_locations_user() {
-		$locs = array();
-		if (isset(Timber::$locations)) {
-			if (is_string(Timber::$locations)) {
-				Timber::$locations = array(Timber::$locations);
-			}
-			foreach (Timber::$locations as $tloc) {
-				$tloc = realpath($tloc);
-				if (is_dir($tloc)) {
-					$locs[] = $tloc;
-				}
-			}
-		}
-		return $locs;
-	}
-
-	/**
-	 * @param bool|string   $caller the calling directory
-	 * @return array
-	 */
-	function get_locations_caller($caller = false) {
-		$locs = array();
-		if ($caller && is_string($caller)) {
-			$caller = trailingslashit($caller);
-			if (is_dir($caller)) {
-				$locs[] = $caller;
-			}
-			foreach ($this->get_locations_theme_dir() as $dirname) {
-				$caller_sub = $caller . trailingslashit($dirname);
-				if (is_dir($caller_sub)) {
-					$locs[] = $caller_sub;
-				}
-			}
-		}
-		return $locs;
-	}
-
-	/**
-	 * @param bool|string   $caller the calling directory (or false)
-	 * @return array
-	 */
-	function get_locations($caller = false) {
-		//prioirty: user locations, caller (but not theme), child theme, parent theme, caller
-		$locs = array();
-		$locs = array_merge($locs, $this->get_locations_user());
-		$locs = array_merge($locs, $this->get_locations_caller($caller));
-		//remove themes from caller
-		$locs = array_diff($locs, $this->get_locations_theme());
-		$locs = array_merge($locs, $this->get_locations_theme());
-		$locs = array_merge($locs, $this->get_locations_caller($caller));
-		$locs = array_unique($locs);
-		$locs = apply_filters('timber_locations', $locs);
-		$locs = apply_filters('timber/locations', $locs);
-		return $locs;
-	}
-
-	/**
-	 * @return Twig_Loader_Filesystem
-	 */
-	function get_loader() {
-		$paths = array();
-		foreach ($this->locations as $loc) {
-			$loc = realpath($loc);
-			if (is_dir($loc)) {
-				$loc = realpath($loc);
-				$paths[] = $loc;
-			} else {
-				//error_log($loc.' is not a directory');
-			}
-		}
-		if (!ini_get('open_basedir')) {
-			$paths[] = '/';
-		} else {
-			$paths[] = ABSPATH;
-		}
-		$paths = apply_filters('timber/loader/paths', $paths);
-		$loader = new Twig_Loader_Filesystem($paths);
-		return $loader;
-	}
-
-	/**
-	 * @return Twig_Environment
-	 */
-	function get_twig() {
-		$loader = $this->get_loader();
-		$params = array('debug' => WP_DEBUG, 'autoescape' => false);
-		if (isset(Timber::$autoescape)) {
-			$params['autoescape'] = Timber::$autoescape;
-		}
-		if (Timber::$cache === true) {
-			Timber::$twig_cache = true;
-		}
-		if (Timber::$twig_cache) {
-			$twig_cache_loc = apply_filters( 'timber/cache/location', TIMBER_LOC . '/cache/twig' );
-			if (!file_exists($twig_cache_loc)) {
-				mkdir($twig_cache_loc, 0777, true);
-			}
-			$params['cache'] = $twig_cache_loc;
-		}
-		$twig = new Twig_Environment($loader, $params);
-		if ( WP_DEBUG ) {
-			$twig->addExtension(new Twig_Extension_Debug());
-		}
-		$twig->addExtension($this->_get_cache_extension());
-
-		$twig = apply_filters('twig_apply_filters', $twig);
-		$twig = apply_filters('timber/twig/filters', $twig);
-		$twig = apply_filters('timber/loader/twig', $twig);
-		return $twig;
-	}
-
-	public function clear_cache_timber($cache_mode = self::CACHE_USE_DEFAULT){
-		//_transient_timberloader
-		$object_cache = false;
-		if (isset($GLOBALS['wp_object_cache']) && is_object($GLOBALS['wp_object_cache'])) {
-			$object_cache = true;
-		}
-		$cache_mode = $this->_get_cache_mode($cache_mode);
-		if (self::CACHE_TRANSIENT === $cache_mode) {
-			global $wpdb;
-			$query = $wpdb->prepare("DELETE FROM $wpdb->options WHERE option_name LIKE '%s'", '_transient_timberloader_%');
-			$wpdb->query( $query );
-			return true;
-		} else if (self::CACHE_SITE_TRANSIENT === $cache_mode) {
-			global $wpdb;
-			$query = $wpdb->prepare("DELETE FROM $wpdb->options WHERE option_name LIKE '%s'", '_transient_timberloader_%');
-			$wpdb->query( $query );
-			return true;
-		} else if (self::CACHE_OBJECT === $cache_mode && $object_cache) {
-			global $wp_object_cache;
-			if (isset($wp_object_cache->cache[self::CACHEGROUP])){
-				unset($wp_object_cache->cache[self::CACHEGROUP]);
-				return true;
-			}
-		}
-		return false;
-	}
-
-	public function clear_cache_twig() {
-		$twig = $this->get_twig();
-		$twig->clearCacheFiles();
-		$cache = $twig->getCache();
-		if ($cache){
-			self::rrmdir($twig->getCache());
-			return true;
-		}
-		return false;
-	}
-
-	/**
-	 * @param string|false $dirPath
-	 */
-	public static function rrmdir($dirPath) {
-		if (! is_dir($dirPath)) {
-			throw new InvalidArgumentException("$dirPath must be a directory");
-		}
-		if (substr($dirPath, strlen($dirPath) - 1, 1) != '/') {
-			$dirPath .= '/';
-		}
-		$files = glob($dirPath . '*', GLOB_MARK);
-		foreach ($files as $file) {
-			if (is_dir($file)) {
-				self::rrmdir($file);
-			} else {
-				unlink($file);
-			}
-		}
-		rmdir($dirPath);
-	}
-
-	/**
-	 * @return \Asm89\Twig\CacheExtension\Extension
-	 */
-	private function _get_cache_extension() {
-
-		$key_generator   = new \Timber\Cache\KeyGenerator();
-		$cache_provider  = new \Timber\Cache\WPObjectCacheAdapter( $this );
-		$cache_strategy  = new \Asm89\Twig\CacheExtension\CacheStrategy\GenerationalCacheStrategy( $cache_provider, $key_generator );
-		$cache_extension = new \Asm89\Twig\CacheExtension\Extension( $cache_strategy );
-
-		return $cache_extension;
-	}
-
-	/**
-	 * @param string $key
-	 * @param string $group
-	 * @param string $cache_mode
-	 * @return bool
-	 */
-	public function get_cache($key, $group = self::CACHEGROUP, $cache_mode = self::CACHE_USE_DEFAULT) {
-		$object_cache = false;
-
-		if (isset($GLOBALS['wp_object_cache']) && is_object($GLOBALS['wp_object_cache'])) {
-			$object_cache = true;
-		}
-
-		$cache_mode = $this->_get_cache_mode($cache_mode);
-
-		$value = false;
-
-		$trans_key = substr($group . '_' . $key, 0, self::TRANS_KEY_LEN);
-		if (self::CACHE_TRANSIENT === $cache_mode)
-			$value = get_transient($trans_key);
-
-		elseif (self::CACHE_SITE_TRANSIENT === $cache_mode)
-			$value = get_site_transient($trans_key);
-
-		elseif (self::CACHE_OBJECT === $cache_mode && $object_cache)
-			$value = wp_cache_get($key, $group);
-
-		return $value;
-	}
-
-	/**
-	 * @param string $key
-	 * @param string|boolean $value
-	 * @param string $group
-	 * @param int $expires
-	 * @param string $cache_mode
-	 * @return string|boolean
-	 */
-	public function set_cache($key, $value, $group = self::CACHEGROUP, $expires = 0, $cache_mode = self::CACHE_USE_DEFAULT) {
-		$object_cache = false;
-
-		if (isset($GLOBALS['wp_object_cache']) && is_object($GLOBALS['wp_object_cache'])) {
-			$object_cache = true;
-		}
-
-		if ((int)$expires < 1)
-			$expires = 0;
-
-		$cache_mode = self::_get_cache_mode($cache_mode);
-		$trans_key = substr($group . '_' . $key, 0, self::TRANS_KEY_LEN);
-
-		if (self::CACHE_TRANSIENT === $cache_mode)
-			set_transient($trans_key, $value, $expires);
-
-		elseif (self::CACHE_SITE_TRANSIENT === $cache_mode)
-			set_site_transient($trans_key, $value, $expires);
-
-		elseif (self::CACHE_OBJECT === $cache_mode && $object_cache)
-			wp_cache_set($key, $value, $group, $expires);
-
-		return $value;
-	}
-
-	/**
-	 * @param string $cache_mode
-	 * @return string
-	 */
-	private function _get_cache_mode($cache_mode) {
-		if (empty($cache_mode) || self::CACHE_USE_DEFAULT === $cache_mode) {
-			$cache_mode = $this->cache_mode;
-		}
-
-		// Fallback if self::$cache_mode did not get a valid value
-		if (!in_array($cache_mode, self::$cache_modes)) {
-			$cache_mode = self::CACHE_OBJECT;
-		}
-
-		return $cache_mode;
-	}
+    const CACHEGROUP = 'timberloader';
+
+    const TRANS_KEY_LEN = 50;
+
+    const CACHE_NONE = 'none';
+    const CACHE_OBJECT = 'cache';
+    const CACHE_TRANSIENT = 'transient';
+    const CACHE_SITE_TRANSIENT = 'site-transient';
+    const CACHE_USE_DEFAULT = 'default';
+
+    public static $cache_modes = array(
+        self::CACHE_NONE,
+        self::CACHE_OBJECT,
+        self::CACHE_TRANSIENT,
+        self::CACHE_SITE_TRANSIENT
+    );
+
+    protected $cache_mode = self::CACHE_TRANSIENT;
+
+    public $locations;
+
+    /**
+     * @param bool|string   $caller the calling directory or false
+     */
+    function __construct($caller = false) {
+        $this->locations = $this->get_locations($caller);
+        $this->cache_mode = apply_filters('timber_cache_mode', $this->cache_mode);
+        $this->cache_mode = apply_filters('timber/cache/mode', $this->cache_mode);
+    }
+
+    /**
+     * @param string        $file
+     * @param array         $data
+     * @param bool          $expires
+     * @param string        $cache_mode
+     * @return bool|string
+     */
+    function render($file, $data = null, $expires = false, $cache_mode = self::CACHE_USE_DEFAULT) {
+        // Different $expires if user is anonymous or logged in
+        if (is_array($expires)) {
+            if (is_user_logged_in() && isset($expires[1])) {
+                $expires = $expires[1];
+            } else {
+                $expires = $expires[0];
+            }
+        }
+
+        $key = null;
+        $output = false;
+        if (false !== $expires) {
+            ksort($data);
+            $key = md5($file . json_encode($data));
+            $output = $this->get_cache($key, self::CACHEGROUP, $cache_mode);
+        }
+
+        if (false === $output || null === $output) {
+            $twig = $this->get_twig();
+            if (strlen($file)) {
+                $loader = $this->get_loader();
+                $result = $loader->getCacheKey($file);
+                do_action('timber_loader_render_file', $result);
+            }
+            $data = apply_filters('timber_loader_render_data', $data);
+            $data = apply_filters('timber/loader/render_data', $data);
+            $output = $twig->render($file, $data);
+        }
+
+        if (false !== $output && false !== $expires && null !== $key) {
+            $this->set_cache($key, $output, self::CACHEGROUP, $expires, $cache_mode);
+        }
+        $output = apply_filters('timber_output', $output);
+        return apply_filters('timber/output', $output);
+    }
+
+    /**
+     * @param array $filenames
+     * @return bool
+     */
+    public function choose_template($filenames) {
+        if (is_array($filenames)) {
+            /* its an array so we have to figure out which one the dev wants */
+            foreach ($filenames as $filename) {
+                if (self::template_exists($filename)) {
+                    return $filename;
+                }
+            }
+            return $filenames[0];
+        }
+        return $filenames;
+    }
+
+    /**
+     * @param string $file
+     * @return bool
+     */
+    protected function template_exists($file) {
+        foreach ($this->locations as $dir) {
+            $look_for = trailingslashit($dir) . $file;
+            if (file_exists($look_for)) {
+                return true;
+            }
+        }
+        return false;
+    }
+
+    /**
+     * @return array
+     */
+    function get_locations_theme() {
+        $theme_locs = array();
+        $child_loc = get_stylesheet_directory();
+        $parent_loc = get_template_directory();
+        if (DIRECTORY_SEPARATOR == '\\') {
+            $child_loc = str_replace('/', '\\', $child_loc);
+            $parent_loc = str_replace('/', '\\', $parent_loc);
+        }
+        $theme_locs[] = $child_loc;
+        foreach ($this->get_locations_theme_dir() as $dirname) {
+            $theme_locs[] = trailingslashit($child_loc) . trailingslashit($dirname);
+        }
+        if ($child_loc != $parent_loc) {
+            $theme_locs[] = $parent_loc;
+            foreach ($this->get_locations_theme_dir() as $dirname) {
+                $theme_locs[] = trailingslashit($parent_loc) . trailingslashit($dirname);
+            }
+        }
+        //now make sure theres a trailing slash on everything
+        $theme_locs = array_map('trailingslashit', $theme_locs);
+        return $theme_locs;
+    }
+
+    /**
+     * returns an array of the directory inside themes that holds twig files
+     * @return string[] the names of directores, ie: array('templats', 'views');
+     */
+    private function get_locations_theme_dir() {
+        if (is_string(Timber::$dirname)) {
+            return array(Timber::$dirname);
+        }
+        return Timber::$dirname;
+    }
+
+    /**
+     * @return array
+     */
+    function get_locations_user() {
+        $locs = array();
+        if (isset(Timber::$locations)) {
+            if (is_string(Timber::$locations)) {
+                Timber::$locations = array(Timber::$locations);
+            }
+            foreach (Timber::$locations as $tloc) {
+                $tloc = realpath($tloc);
+                if (is_dir($tloc)) {
+                    $locs[] = $tloc;
+                }
+            }
+        }
+        return $locs;
+    }
+
+    /**
+     * @param bool|string   $caller the calling directory
+     * @return array
+     */
+    function get_locations_caller($caller = false) {
+        $locs = array();
+        if ($caller && is_string($caller)) {
+            $caller = trailingslashit($caller);
+            if (is_dir($caller)) {
+                $locs[] = $caller;
+            }
+            foreach ($this->get_locations_theme_dir() as $dirname) {
+                $caller_sub = $caller . trailingslashit($dirname);
+                if (is_dir($caller_sub)) {
+                    $locs[] = $caller_sub;
+                }
+            }
+        }
+        return $locs;
+    }
+
+    /**
+     * @param bool|string   $caller the calling directory (or false)
+     * @return array
+     */
+    function get_locations($caller = false) {
+        //prioirty: user locations, caller (but not theme), child theme, parent theme, caller
+        $locs = array();
+        $locs = array_merge($locs, $this->get_locations_user());
+        $locs = array_merge($locs, $this->get_locations_caller($caller));
+        //remove themes from caller
+        $locs = array_diff($locs, $this->get_locations_theme());
+        $locs = array_merge($locs, $this->get_locations_theme());
+        $locs = array_merge($locs, $this->get_locations_caller($caller));
+        $locs = array_unique($locs);
+        $locs = apply_filters('timber_locations', $locs);
+        $locs = apply_filters('timber/locations', $locs);
+        return $locs;
+    }
+
+    /**
+     * @return Twig_Loader_Filesystem
+     */
+    function get_loader() {
+        $paths = array();
+        foreach ($this->locations as $loc) {
+            $loc = realpath($loc);
+            if (is_dir($loc)) {
+                $loc = realpath($loc);
+                $paths[] = $loc;
+            } else {
+                //error_log($loc.' is not a directory');
+            }
+        }
+        if (!ini_get('open_basedir')) {
+            $paths[] = '/';
+        } else {
+            $paths[] = ABSPATH;
+        }
+        $paths = apply_filters('timber/loader/paths', $paths);
+        $loader = new Twig_Loader_Filesystem($paths);
+        return $loader;
+    }
+
+    /**
+     * @return Twig_Environment
+     */
+    function get_twig() {
+        $loader = $this->get_loader();
+        $params = array('debug' => WP_DEBUG, 'autoescape' => false);
+        if (isset(Timber::$autoescape)) {
+            $params['autoescape'] = Timber::$autoescape;
+        }
+        if (Timber::$cache === true) {
+            Timber::$twig_cache = true;
+        }
+        if (Timber::$twig_cache) {
+            $twig_cache_loc = apply_filters( 'timber/cache/location', TIMBER_LOC . '/cache/twig' );
+            if (!file_exists($twig_cache_loc)) {
+                mkdir($twig_cache_loc, 0777, true);
+            }
+            $params['cache'] = $twig_cache_loc;
+        }
+        $twig = new Twig_Environment($loader, $params);
+        if ( WP_DEBUG ) {
+            $twig->addExtension(new Twig_Extension_Debug());
+        }
+        $twig->addExtension($this->_get_cache_extension());
+
+        $twig = apply_filters('twig_apply_filters', $twig);
+        $twig = apply_filters('timber/twig/filters', $twig);
+        $twig = apply_filters('timber/loader/twig', $twig);
+        return $twig;
+    }
+
+    public function clear_cache_timber($cache_mode = self::CACHE_USE_DEFAULT){
+        //_transient_timberloader
+        $object_cache = false;
+        if (isset($GLOBALS['wp_object_cache']) && is_object($GLOBALS['wp_object_cache'])) {
+            $object_cache = true;
+        }
+        $cache_mode = $this->_get_cache_mode($cache_mode);
+        if (self::CACHE_TRANSIENT === $cache_mode) {
+            global $wpdb;
+            $query = $wpdb->prepare("DELETE FROM $wpdb->options WHERE option_name LIKE '%s'", '_transient_timberloader_%');
+            $wpdb->query( $query );
+            return true;
+        } else if (self::CACHE_SITE_TRANSIENT === $cache_mode) {
+            global $wpdb;
+            $query = $wpdb->prepare("DELETE FROM $wpdb->options WHERE option_name LIKE '%s'", '_transient_timberloader_%');
+            $wpdb->query( $query );
+            return true;
+        } else if (self::CACHE_OBJECT === $cache_mode && $object_cache) {
+            global $wp_object_cache;
+            if (isset($wp_object_cache->cache[self::CACHEGROUP])){
+                unset($wp_object_cache->cache[self::CACHEGROUP]);
+                return true;
+            }
+        }
+        return false;
+    }
+
+    public function clear_cache_twig() {
+        $twig = $this->get_twig();
+        $twig->clearCacheFiles();
+        $cache = $twig->getCache();
+        if ($cache){
+            self::rrmdir($twig->getCache());
+            return true;
+        }
+        return false;
+    }
+
+    /**
+     * @param string|false $dirPath
+     */
+    public static function rrmdir($dirPath) {
+        if (! is_dir($dirPath)) {
+            throw new InvalidArgumentException("$dirPath must be a directory");
+        }
+        if (substr($dirPath, strlen($dirPath) - 1, 1) != '/') {
+            $dirPath .= '/';
+        }
+        $files = glob($dirPath . '*', GLOB_MARK);
+        foreach ($files as $file) {
+            if (is_dir($file)) {
+                self::rrmdir($file);
+            } else {
+                unlink($file);
+            }
+        }
+        rmdir($dirPath);
+    }
+
+    /**
+     * @return \Asm89\Twig\CacheExtension\Extension
+     */
+    private function _get_cache_extension() {
+
+        $key_generator   = new \Timber\Cache\KeyGenerator();
+        $cache_provider  = new \Timber\Cache\WPObjectCacheAdapter( $this );
+        $cache_strategy  = new \Asm89\Twig\CacheExtension\CacheStrategy\GenerationalCacheStrategy( $cache_provider, $key_generator );
+        $cache_extension = new \Asm89\Twig\CacheExtension\Extension( $cache_strategy );
+
+        return $cache_extension;
+    }
+
+    /**
+     * @param string $key
+     * @param string $group
+     * @param string $cache_mode
+     * @return bool
+     */
+    public function get_cache($key, $group = self::CACHEGROUP, $cache_mode = self::CACHE_USE_DEFAULT) {
+        $object_cache = false;
+
+        if (isset($GLOBALS['wp_object_cache']) && is_object($GLOBALS['wp_object_cache'])) {
+            $object_cache = true;
+        }
+
+        $cache_mode = $this->_get_cache_mode($cache_mode);
+
+        $value = false;
+
+        $trans_key = substr($group . '_' . $key, 0, self::TRANS_KEY_LEN);
+        if (self::CACHE_TRANSIENT === $cache_mode)
+            $value = get_transient($trans_key);
+
+        elseif (self::CACHE_SITE_TRANSIENT === $cache_mode)
+            $value = get_site_transient($trans_key);
+
+        elseif (self::CACHE_OBJECT === $cache_mode && $object_cache)
+            $value = wp_cache_get($key, $group);
+
+        return $value;
+    }
+
+    /**
+     * @param string $key
+     * @param string|boolean $value
+     * @param string $group
+     * @param int $expires
+     * @param string $cache_mode
+     * @return string|boolean
+     */
+    public function set_cache($key, $value, $group = self::CACHEGROUP, $expires = 0, $cache_mode = self::CACHE_USE_DEFAULT) {
+        $object_cache = false;
+
+        if (isset($GLOBALS['wp_object_cache']) && is_object($GLOBALS['wp_object_cache'])) {
+            $object_cache = true;
+        }
+
+        if ((int)$expires < 1)
+            $expires = 0;
+
+        $cache_mode = self::_get_cache_mode($cache_mode);
+        $trans_key = substr($group . '_' . $key, 0, self::TRANS_KEY_LEN);
+
+        if (self::CACHE_TRANSIENT === $cache_mode)
+            set_transient($trans_key, $value, $expires);
+
+        elseif (self::CACHE_SITE_TRANSIENT === $cache_mode)
+            set_site_transient($trans_key, $value, $expires);
+
+        elseif (self::CACHE_OBJECT === $cache_mode && $object_cache)
+            wp_cache_set($key, $value, $group, $expires);
+
+        return $value;
+    }
+
+    /**
+     * @param string $cache_mode
+     * @return string
+     */
+    private function _get_cache_mode($cache_mode) {
+        if (empty($cache_mode) || self::CACHE_USE_DEFAULT === $cache_mode) {
+            $cache_mode = $this->cache_mode;
+        }
+
+        // Fallback if self::$cache_mode did not get a valid value
+        if (!in_array($cache_mode, self::$cache_modes)) {
+            $cache_mode = self::CACHE_OBJECT;
+        }
+
+        return $cache_mode;
+    }
 
 }

lib/timber-term.php

Indentation +387 added lines, -387 removed lines

@@ -32,398 +32,398 @@
  */
 class TimberTerm extends TimberCore implements TimberCoreInterface {
 
-	public $PostClass = 'TimberPost';
-	public $TermClass = 'TimberTerm';
-
-	public $object_type = 'term';
-	public static $representation = 'term';
-
-	public $_children;
-	/**
-	 * @api
-	 * @var string the human-friendly name of the term (ex: French Cuisine)
-	 */
-	public $name;
-	/**
-	 * @api
-	 * @var strng the WordPress taxonomy slug (ex: `post_tag` or `actors`)
-	 */
-	public $taxonomy;
-
-	/**
-	 * @param int $tid
-	 * @param string $tax
-	 */
-	public function __construct( $tid = null, $tax = '' ) {
-		if ($tid === null) {
-			$tid = $this->get_term_from_query();
-		}
-		if (strlen($tax)) {
-			$this->taxonomy = $tax;
-		}
-		$this->init($tid);
-	}
-
-	/**
-	 * @return string
-	 */
-	public function __toString() {
-		return $this->name;
-	}
-
-	/**
-	 * @param $tid
-	 * @param $taxonomy
-	 *
-	 * @return static
-	 */
-	public static function from( $tid, $taxonomy ) {
-		return new static($tid, $taxonomy);
-	}
-
-
-	/* Setup
+    public $PostClass = 'TimberPost';
+    public $TermClass = 'TimberTerm';
+
+    public $object_type = 'term';
+    public static $representation = 'term';
+
+    public $_children;
+    /**
+     * @api
+     * @var string the human-friendly name of the term (ex: French Cuisine)
+     */
+    public $name;
+    /**
+     * @api
+     * @var strng the WordPress taxonomy slug (ex: `post_tag` or `actors`)
+     */
+    public $taxonomy;
+
+    /**
+     * @param int $tid
+     * @param string $tax
+     */
+    public function __construct( $tid = null, $tax = '' ) {
+        if ($tid === null) {
+            $tid = $this->get_term_from_query();
+        }
+        if (strlen($tax)) {
+            $this->taxonomy = $tax;
+        }
+        $this->init($tid);
+    }
+
+    /**
+     * @return string
+     */
+    public function __toString() {
+        return $this->name;
+    }
+
+    /**
+     * @param $tid
+     * @param $taxonomy
+     *
+     * @return static
+     */
+    public static function from( $tid, $taxonomy ) {
+        return new static($tid, $taxonomy);
+    }
+
+
+    /* Setup
 	===================== */
 
-	/**
-	 * @internal
-	 * @return integer
-	 */
-	protected function get_term_from_query() {
-		global $wp_query;
-		if ( isset($wp_query->queried_object) ) {
-			$qo = $wp_query->queried_object;
-			if (isset($qo->term_id)) {
-				return $qo->term_id;
-			}
-		}
-		if ( isset($wp_query->tax_query->queries[0]['terms'][0]) ) {
-			return $wp_query->tax_query->queries[0]['terms'][0];
-		}
-	}
-
-	/**
-	 * @internal
-	 * @param int $tid
-	 */
-	protected function init( $tid ) {
-		$term = $this->get_term($tid);
-		if ( isset($term->id) ) {
-			$term->ID = $term->id;
-		} else if ( isset($term->term_id) ) {
-			$term->ID = $term->term_id;
-		} else if ( is_string($tid) ) {
-			//echo 'bad call using '.$tid;
-			//TimberHelper::error_log(debug_backtrace());
-		}
-		if ( isset($term->ID) ){
-			$term->id = $term->ID;
-			$this->import($term);
-			if ( isset($term->term_id) ) {
-				$custom = $this->get_term_meta($term->term_id);
-				$this->import($custom);
-			}
-		}
-	}
-
-	/**
-	 * @internal
-	 * @param int $tid
-	 * @return array
-	 */
-	protected function get_term_meta($tid) {
-		$customs = array();
-		$customs = apply_filters('timber_term_get_meta', $customs, $tid, $this);
-		return apply_filters('timber/term/meta', $customs, $tid, $this);
-	}
-
-	/**
-	 * @internal
-	 * @param int $tid
-	 * @return mixed
-	 */
-	protected function get_term( $tid ) {
-		if ( is_object($tid) || is_array($tid) ) {
-			return $tid;
-		}
-		$tid = self::get_tid($tid);
-
-		if ( isset($this->taxonomy) && strlen($this->taxonomy) ) {
-			return get_term($tid, $this->taxonomy);
-		} else {
-			global $wpdb;
-			$query = $wpdb->prepare("SELECT taxonomy FROM $wpdb->term_taxonomy WHERE term_id = %d LIMIT 1", $tid);
-			$tax = $wpdb->get_var($query);
-			if (isset($tax) && strlen($tax)) {
-				$this->taxonomy = $tax;
-				return get_term($tid, $tax);
-			}
-		}
-		return null;
-	}
-
-	/**
-	 * @internal
-	 * @param int $tid
-	 * @return int
-	 */
-	protected function get_tid( $tid ) {
-		global $wpdb;
-		if ( is_numeric($tid) ) {
-			return $tid;
-		}
-		if ( gettype($tid) == 'object' ) {
-			$tid = $tid->term_id;
-		}
-		if ( is_numeric($tid) ) {
-			$query = $wpdb->prepare("SELECT * FROM $wpdb->terms WHERE term_id = %d", $tid);
-		} else {
-			$query = $wpdb->prepare("SELECT * FROM $wpdb->terms WHERE slug = %s", $tid);
-		}
-		$result = $wpdb->get_row($query);
-		if ( isset($result->term_id) ) {
-			$result->ID = $result->term_id;
-			$result->id = $result->term_id;
-			return $result->ID;
-		}
-		return 0;
-	}
-
-	/* Public methods
+    /**
+     * @internal
+     * @return integer
+     */
+    protected function get_term_from_query() {
+        global $wp_query;
+        if ( isset($wp_query->queried_object) ) {
+            $qo = $wp_query->queried_object;
+            if (isset($qo->term_id)) {
+                return $qo->term_id;
+            }
+        }
+        if ( isset($wp_query->tax_query->queries[0]['terms'][0]) ) {
+            return $wp_query->tax_query->queries[0]['terms'][0];
+        }
+    }
+
+    /**
+     * @internal
+     * @param int $tid
+     */
+    protected function init( $tid ) {
+        $term = $this->get_term($tid);
+        if ( isset($term->id) ) {
+            $term->ID = $term->id;
+        } else if ( isset($term->term_id) ) {
+            $term->ID = $term->term_id;
+        } else if ( is_string($tid) ) {
+            //echo 'bad call using '.$tid;
+            //TimberHelper::error_log(debug_backtrace());
+        }
+        if ( isset($term->ID) ){
+            $term->id = $term->ID;
+            $this->import($term);
+            if ( isset($term->term_id) ) {
+                $custom = $this->get_term_meta($term->term_id);
+                $this->import($custom);
+            }
+        }
+    }
+
+    /**
+     * @internal
+     * @param int $tid
+     * @return array
+     */
+    protected function get_term_meta($tid) {
+        $customs = array();
+        $customs = apply_filters('timber_term_get_meta', $customs, $tid, $this);
+        return apply_filters('timber/term/meta', $customs, $tid, $this);
+    }
+
+    /**
+     * @internal
+     * @param int $tid
+     * @return mixed
+     */
+    protected function get_term( $tid ) {
+        if ( is_object($tid) || is_array($tid) ) {
+            return $tid;
+        }
+        $tid = self::get_tid($tid);
+
+        if ( isset($this->taxonomy) && strlen($this->taxonomy) ) {
+            return get_term($tid, $this->taxonomy);
+        } else {
+            global $wpdb;
+            $query = $wpdb->prepare("SELECT taxonomy FROM $wpdb->term_taxonomy WHERE term_id = %d LIMIT 1", $tid);
+            $tax = $wpdb->get_var($query);
+            if (isset($tax) && strlen($tax)) {
+                $this->taxonomy = $tax;
+                return get_term($tid, $tax);
+            }
+        }
+        return null;
+    }
+
+    /**
+     * @internal
+     * @param int $tid
+     * @return int
+     */
+    protected function get_tid( $tid ) {
+        global $wpdb;
+        if ( is_numeric($tid) ) {
+            return $tid;
+        }
+        if ( gettype($tid) == 'object' ) {
+            $tid = $tid->term_id;
+        }
+        if ( is_numeric($tid) ) {
+            $query = $wpdb->prepare("SELECT * FROM $wpdb->terms WHERE term_id = %d", $tid);
+        } else {
+            $query = $wpdb->prepare("SELECT * FROM $wpdb->terms WHERE slug = %s", $tid);
+        }
+        $result = $wpdb->get_row($query);
+        if ( isset($result->term_id) ) {
+            $result->ID = $result->term_id;
+            $result->id = $result->term_id;
+            return $result->ID;
+        }
+        return 0;
+    }
+
+    /* Public methods
 	===================== */
 
-	/**
-	 * @internal
-	 * @return string
-	 */
-	public function get_edit_url() {
-		return get_edit_term_link($this->ID, $this->taxonomy);
-	}
-
-	/**
-	 * @internal
-	 * @param string $field_name
-	 * @return string
-	 */
-	public function get_meta_field( $field_name ) {
-		if (!isset($this->$field_name)) {
-			$field_value = '';
-			$field_value = apply_filters('timber_term_get_meta_field', $field_value, $this->ID, $field_name, $this);
-			$field_value = apply_filters('timber/term/meta/field', $field_value, $this->ID, $field_name, $this);
-			$this->$field_name = $field_value;
-		}
-		return $this->$field_name;
-	}
-
-	/**
-	 * @internal
-	 * @return string
-	 */
-	public function get_path() {
-		$link = $this->get_link();
-		$rel = TimberURLHelper::get_rel_url($link, true);
-		$rel = apply_filters('timber_term_path', $rel, $this);
-		return apply_filters('timber/term/path', $rel, $this);
-	}
-
-	/**
-	 * @internal
-	 * @return string
-	 */
-	public function get_link() {
-		$link = get_term_link($this);
-		$link = apply_filters('timber_term_link', $link, $this);
-		return apply_filters('timber/term/link', $link, $this);
-	}
-
-	/**
-	 * Get Posts that have been "tagged" with the particular term
-	 * @internal
-	 * @param int $numberposts
-	 * @param string $post_type
-	 * @param string $PostClass
-	 * @return array|bool|null
-	 */
-	public function get_posts( $numberposts = 10, $post_type = 'any', $PostClass = '' ) {
-		if (!strlen($PostClass)) {
-			$PostClass = $this->PostClass;
-		}
-		$default_tax_query = array(array(
-			'field' => 'id',
-			'terms' => $this->ID,
-			'taxonomy' => $this->taxonomy,
-		));
-		if ( is_string($numberposts) && strstr($numberposts, '=') ) {
-			$args = $numberposts;
-			$new_args = array();
-			parse_str($args, $new_args);
-			$args = $new_args;
-			$args['tax_query'] = $default_tax_query;
-			if (!isset($args['post_type'])) {
-				$args['post_type'] = 'any';
-			}
-			if (class_exists($post_type)) {
-				$PostClass = $post_type;
-			}
-		} else if ( is_array($numberposts) ) {
-			//they sent us an array already baked
-			$args = $numberposts;
-			if ( !isset($args['tax_query']) ) {
-				$args['tax_query'] = $default_tax_query;
-			}
-			if ( class_exists($post_type) ) {
-				$PostClass = $post_type;
-			}
-			if ( !isset($args['post_type']) ) {
-				$args['post_type'] = 'any';
-			}
-		} else {
-			$args = array(
-				'numberposts' => $numberposts,
-				'tax_query' => $default_tax_query,
-				'post_type' => $post_type
-			);
-		}
-		return Timber::get_posts($args, $PostClass);
-	}
-
-	/**
-	 * @internal
-	 * @return array
-	 */
-	public function get_children() {
-		if ( !isset($this->_children) ) {
-			$children = get_term_children($this->ID, $this->taxonomy);
-			foreach ($children as &$child) {
-				$child = new TimberTerm($child);
-			}
-			$this->_children = $children;
-		}
-		return $this->_children;
-	}
-
-	/**
-	 *
-	 *
-	 * @param string  $key
-	 * @param mixed   $value
-	 */
-	function update( $key, $value ) {
-		$value = apply_filters( 'timber_term_set_meta', $value, $key, $this->ID, $this );
-		$this->$key = $value;
-	}
-
-	/* Alias
+    /**
+     * @internal
+     * @return string
+     */
+    public function get_edit_url() {
+        return get_edit_term_link($this->ID, $this->taxonomy);
+    }
+
+    /**
+     * @internal
+     * @param string $field_name
+     * @return string
+     */
+    public function get_meta_field( $field_name ) {
+        if (!isset($this->$field_name)) {
+            $field_value = '';
+            $field_value = apply_filters('timber_term_get_meta_field', $field_value, $this->ID, $field_name, $this);
+            $field_value = apply_filters('timber/term/meta/field', $field_value, $this->ID, $field_name, $this);
+            $this->$field_name = $field_value;
+        }
+        return $this->$field_name;
+    }
+
+    /**
+     * @internal
+     * @return string
+     */
+    public function get_path() {
+        $link = $this->get_link();
+        $rel = TimberURLHelper::get_rel_url($link, true);
+        $rel = apply_filters('timber_term_path', $rel, $this);
+        return apply_filters('timber/term/path', $rel, $this);
+    }
+
+    /**
+     * @internal
+     * @return string
+     */
+    public function get_link() {
+        $link = get_term_link($this);
+        $link = apply_filters('timber_term_link', $link, $this);
+        return apply_filters('timber/term/link', $link, $this);
+    }
+
+    /**
+     * Get Posts that have been "tagged" with the particular term
+     * @internal
+     * @param int $numberposts
+     * @param string $post_type
+     * @param string $PostClass
+     * @return array|bool|null
+     */
+    public function get_posts( $numberposts = 10, $post_type = 'any', $PostClass = '' ) {
+        if (!strlen($PostClass)) {
+            $PostClass = $this->PostClass;
+        }
+        $default_tax_query = array(array(
+            'field' => 'id',
+            'terms' => $this->ID,
+            'taxonomy' => $this->taxonomy,
+        ));
+        if ( is_string($numberposts) && strstr($numberposts, '=') ) {
+            $args = $numberposts;
+            $new_args = array();
+            parse_str($args, $new_args);
+            $args = $new_args;
+            $args['tax_query'] = $default_tax_query;
+            if (!isset($args['post_type'])) {
+                $args['post_type'] = 'any';
+            }
+            if (class_exists($post_type)) {
+                $PostClass = $post_type;
+            }
+        } else if ( is_array($numberposts) ) {
+            //they sent us an array already baked
+            $args = $numberposts;
+            if ( !isset($args['tax_query']) ) {
+                $args['tax_query'] = $default_tax_query;
+            }
+            if ( class_exists($post_type) ) {
+                $PostClass = $post_type;
+            }
+            if ( !isset($args['post_type']) ) {
+                $args['post_type'] = 'any';
+            }
+        } else {
+            $args = array(
+                'numberposts' => $numberposts,
+                'tax_query' => $default_tax_query,
+                'post_type' => $post_type
+            );
+        }
+        return Timber::get_posts($args, $PostClass);
+    }
+
+    /**
+     * @internal
+     * @return array
+     */
+    public function get_children() {
+        if ( !isset($this->_children) ) {
+            $children = get_term_children($this->ID, $this->taxonomy);
+            foreach ($children as &$child) {
+                $child = new TimberTerm($child);
+            }
+            $this->_children = $children;
+        }
+        return $this->_children;
+    }
+
+    /**
+     *
+     *
+     * @param string  $key
+     * @param mixed   $value
+     */
+    function update( $key, $value ) {
+        $value = apply_filters( 'timber_term_set_meta', $value, $key, $this->ID, $this );
+        $this->$key = $value;
+    }
+
+    /* Alias
 	====================== */
 
-	/**
-	 * @api
-	 * @return array
-	 */
-	public function children() {
-		return $this->get_children();
-	}
-
-	/**
-	 * @api
-	 * @return string
-	 */
-	public function description() {
-		$prefix = '<p>';
-		$suffix = '</p>';
-		$desc = term_description( $this->ID, $this->taxonomy );
-		if (substr($desc, 0, strlen($prefix)) == $prefix) {
-    		$desc = substr($desc, strlen($prefix));
-		}
-		$desc = preg_replace('/'. preg_quote('</p>', '/') . '$/', '', $desc);
-		return trim($desc);
-	}
-
-	/**
-	 * @api
-	 * @return string
-	 */
-	public function edit_link() {
-		return $this->get_edit_url();
-	}
-
-	/**
-	 * @internal
-	 * @deprecated 0.21.8 use TimberTerm::link() instead
-	 * @return string
-	 */
-	public function get_url() {
-		return $this->get_link();
-	}
-
-	/**
-	 * @api
-	 * @return string
-	 */
-	public function link() {
-		return $this->get_link();
-	}
-
-	/**
-	 * @api
-	 * @param string $field_name
-	 * @return string
-	 */
-	public function meta( $field_name ) {
-		return $this->get_meta_field($field_name);
-	}
-
-	/**
-	 * @api
-	 * @return string
-	 */
-	public function path() {
-		return $this->get_path();
-	}
-
-	/**
-	 * @api
-	 * @param int $numberposts_or_args
-	 * @param string $post_type_or_class
-	 * @param string $post_class
-	 * @example
-	 * ```twig
-	 * <h4>Recent posts in {{term.name}}</h4>
-	 * <ul>
-	 * {% for post in term.posts(3, 'post') %}
-	 *     <li><a href="{{post.link}}">{{post.title}}</a></li>
-	 * {% endfor %}
-	 * </ul>
-	 * ```
-	 * @return array|bool|null
-	 */
-	public function posts( $numberposts_or_args = 10, $post_type_or_class = 'any', $post_class = '' ) {
-		return $this->get_posts($numberposts_or_args, $post_type_or_class, $post_class);
-	}
-
-	/**
-	 * @api
-	 * @return string
-	 */
-	public function title() {
-		return $this->name;
-	}
-
-	/**
-	 * @deprecated 0.21.9 use TimberTerm::link() instead
-	 * @return string
-	 */
-	public function url() {
-		return $this->get_url();
-	}
-
-	/**
-	 * @deprecated 0.20.0 this was a dumb idea
-	 * @param int $i
-	 * @return string
-	 */
-	function get_page( $i ) {
-		return $this->get_path() . '/page/' . $i;
-	}
+    /**
+     * @api
+     * @return array
+     */
+    public function children() {
+        return $this->get_children();
+    }
+
+    /**
+     * @api
+     * @return string
+     */
+    public function description() {
+        $prefix = '<p>';
+        $suffix = '</p>';
+        $desc = term_description( $this->ID, $this->taxonomy );
+        if (substr($desc, 0, strlen($prefix)) == $prefix) {
+            $desc = substr($desc, strlen($prefix));
+        }
+        $desc = preg_replace('/'. preg_quote('</p>', '/') . '$/', '', $desc);
+        return trim($desc);
+    }
+
+    /**
+     * @api
+     * @return string
+     */
+    public function edit_link() {
+        return $this->get_edit_url();
+    }
+
+    /**
+     * @internal
+     * @deprecated 0.21.8 use TimberTerm::link() instead
+     * @return string
+     */
+    public function get_url() {
+        return $this->get_link();
+    }
+
+    /**
+     * @api
+     * @return string
+     */
+    public function link() {
+        return $this->get_link();
+    }
+
+    /**
+     * @api
+     * @param string $field_name
+     * @return string
+     */
+    public function meta( $field_name ) {
+        return $this->get_meta_field($field_name);
+    }
+
+    /**
+     * @api
+     * @return string
+     */
+    public function path() {
+        return $this->get_path();
+    }
+
+    /**
+     * @api
+     * @param int $numberposts_or_args
+     * @param string $post_type_or_class
+     * @param string $post_class
+     * @example
+     * ```twig
+     * <h4>Recent posts in {{term.name}}</h4>
+     * <ul>
+     * {% for post in term.posts(3, 'post') %}
+     *     <li><a href="{{post.link}}">{{post.title}}</a></li>
+     * {% endfor %}
+     * </ul>
+     * ```
+     * @return array|bool|null
+     */
+    public function posts( $numberposts_or_args = 10, $post_type_or_class = 'any', $post_class = '' ) {
+        return $this->get_posts($numberposts_or_args, $post_type_or_class, $post_class);
+    }
+
+    /**
+     * @api
+     * @return string
+     */
+    public function title() {
+        return $this->name;
+    }
+
+    /**
+     * @deprecated 0.21.9 use TimberTerm::link() instead
+     * @return string
+     */
+    public function url() {
+        return $this->get_url();
+    }
+
+    /**
+     * @deprecated 0.20.0 this was a dumb idea
+     * @param int $i
+     * @return string
+     */
+    function get_page( $i ) {
+        return $this->get_path() . '/page/' . $i;
+    }
 
 }

lib/timber-user.php

Indentation +225 added lines, -225 removed lines

@@ -19,230 +19,230 @@
  */
 class TimberUser extends TimberCore implements TimberCoreInterface {
 
-	public $object_type = 'user';
-	public static $representation = 'user';
-
-	public $_link;
-
-	/**
-	 * @api
-	 * @var string The description from WordPress
-	 */
-	public $description;
-	public $display_name;
-
-	/**
-	 * @api
-	 * @var  string The first name of the user
-	 */
-	public $first_name;
-
-	/**
-	 * @api
-	 * @var  string The last name of the user
-	 */
-	public $last_name;
-
-	/**
-	 * @api
-	 * @var int The ID from WordPress
-	 */
-	public $id;
-	public $user_nicename;
-
-	/**
-	 * @param int|bool $uid
-	 */
-	function __construct($uid = false) {
-		$this->init($uid);
-	}
-
-	/**
-	 * @example
-	 * ```twig
-	 * This post is by {{ post.author }}
-	 * ```
-	 * ```html
-	 * This post is by Jared Novack
-	 * ```
-	 *
-	 * @return string a fallback for TimberUser::name()
-	 */
-	function __toString() {
-		$name = $this->name();
-		if ( strlen($name) ) {
-			return $name;
-		}
-		if ( strlen($this->name) ) {
-			return $this->name;
-		}
-		return '';
-	}
-
-	/**
-	 * @internal
-	 * @param string $field_name
-	 * @return null
-	 */
-	function get_meta($field_name) {
-		return $this->get_meta_field($field_name);
-	}
-
-	/**
-	 * @internal
-	 * @param string 	$field
-	 * @param mixed 	$value
-	 */
-	function __set($field, $value) {
-		if ( $field == 'name' ) {
-			$this->display_name = $value;
-		}
-		$this->$field = $value;
-	}
-
-	/**
-	 * @internal
-	 * @param int|bool $uid The user ID to use
-	 */
-	protected function init($uid = false) {
-		if ( $uid === false ) {
-			$uid = get_current_user_id();
-		}
-		if ( is_object($uid) || is_array($uid) ) {
-			$data = $uid;
-			if ( is_array($uid) ) {
-				$data = (object) $uid;
-			}
-			$uid = $data->ID;
-		}
-		if ( is_numeric($uid) ) {
-			$data = get_userdata($uid);
-		} else if ( is_string($uid) ) {
-			$data = get_user_by('login', $uid);
-		}
-		if ( isset($data) && is_object($data) ) {
-			if ( isset($data->data) ) {
-				$this->import($data->data);
-			} else {
-				$this->import($data);
-			}
-		}
-		$this->id = $this->ID;
-		$this->name = $this->name();
-		$custom = $this->get_custom();
-		$this->import($custom);
-	}
-
-	/**
-	 * @param string $field_name
-	 * @return mixed
-	 */
-	function get_meta_field($field_name) {
-		$value = null;
-		$value = apply_filters('timber_user_get_meta_field_pre', $value, $this->ID, $field_name, $this);
-		if ( $value === null ) {
-			$value = get_user_meta($this->ID, $field_name, true);
-		}
-		$value = apply_filters('timber_user_get_meta_field', $value, $this->ID, $field_name, $this);
-		return $value;
-	}
-
-	/**
-	 * @return array|null
-	 */
-	function get_custom() {
-		if ( $this->ID ) {
-			$um = array();
-			$um = apply_filters('timber_user_get_meta_pre', $um, $this->ID, $this);
-			if ( empty($um) ) {
-				$um = get_user_meta($this->ID);
-			}
-			$custom = array();
-			foreach ($um as $key => $value) {
-				if ( is_array($value) && count($value) == 1 ) {
-					$value = $value[0];
-				}
-				$custom[$key] = maybe_unserialize($value);
-			}
-			$custom = apply_filters('timber_user_get_meta', $custom, $this->ID, $this);
-			return $custom;
-		}
-		return null;
-	}
-
-	/**
-	 * @api
-	 * @return string http://example.org/author/lincoln
-	 */
-	public function link() {
-		if ( !$this->_link ) {
-			$this->_link = untrailingslashit(get_author_posts_url($this->ID));
-		}
-		return $this->_link;
-	}
-
-	/**
-	 * @api
-	 * @return string the human-friendly name of the user (ex: "Buster Bluth")
-	 */
-	function name() {
-		return $this->display_name;
-	}
-
-	/**
-	 * @param string $field_name
-	 * @return mixed
-	 */
-	function meta($field_name) {
-		return $this->get_meta_field($field_name);
-	}
-
-	/**
-	 * @api
-	 * @return string ex: /author/lincoln
-	 */
-	public function path() {
-		return TimberURLHelper::get_rel_url($this->get_link());
-	}
-
-	/**
-	 * @api
-	 * @return string ex baberaham-lincoln
-	 */
-	public function slug() {
-		return $this->user_nicename;
-	}
-
-	/**
-	 * @deprecated 0.21.9
-	 * @return string The link to a user's profile page
-	 */
-	function get_link() {
-		return $this->link();
-	}
-
-	/**
-	 * @deprecated 0.21.8
-	 * @return string ex: /author/lincoln
-	 */
-	function get_path() {
-		return $this->path();
-	}
-
-	/**
-	 * @deprecated 0.21.8
-	 * @return string
-	 */
-	function get_permalink() {
-		return $this->get_link();
-	}
-
-	/**
-	 * @deprecated 0.21.8
-	 * @return string
-	 */
-	function permalink() {
-		return $this->get_permalink();
-	}
+    public $object_type = 'user';
+    public static $representation = 'user';
+
+    public $_link;
+
+    /**
+     * @api
+     * @var string The description from WordPress
+     */
+    public $description;
+    public $display_name;
+
+    /**
+     * @api
+     * @var  string The first name of the user
+     */
+    public $first_name;
+
+    /**
+     * @api
+     * @var  string The last name of the user
+     */
+    public $last_name;
+
+    /**
+     * @api
+     * @var int The ID from WordPress
+     */
+    public $id;
+    public $user_nicename;
+
+    /**
+     * @param int|bool $uid
+     */
+    function __construct($uid = false) {
+        $this->init($uid);
+    }
+
+    /**
+     * @example
+     * ```twig
+     * This post is by {{ post.author }}
+     * ```
+     * ```html
+     * This post is by Jared Novack
+     * ```
+     *
+     * @return string a fallback for TimberUser::name()
+     */
+    function __toString() {
+        $name = $this->name();
+        if ( strlen($name) ) {
+            return $name;
+        }
+        if ( strlen($this->name) ) {
+            return $this->name;
+        }
+        return '';
+    }
+
+    /**
+     * @internal
+     * @param string $field_name
+     * @return null
+     */
+    function get_meta($field_name) {
+        return $this->get_meta_field($field_name);
+    }
+
+    /**
+     * @internal
+     * @param string 	$field
+     * @param mixed 	$value
+     */
+    function __set($field, $value) {
+        if ( $field == 'name' ) {
+            $this->display_name = $value;
+        }
+        $this->$field = $value;
+    }
+
+    /**
+     * @internal
+     * @param int|bool $uid The user ID to use
+     */
+    protected function init($uid = false) {
+        if ( $uid === false ) {
+            $uid = get_current_user_id();
+        }
+        if ( is_object($uid) || is_array($uid) ) {
+            $data = $uid;
+            if ( is_array($uid) ) {
+                $data = (object) $uid;
+            }
+            $uid = $data->ID;
+        }
+        if ( is_numeric($uid) ) {
+            $data = get_userdata($uid);
+        } else if ( is_string($uid) ) {
+            $data = get_user_by('login', $uid);
+        }
+        if ( isset($data) && is_object($data) ) {
+            if ( isset($data->data) ) {
+                $this->import($data->data);
+            } else {
+                $this->import($data);
+            }
+        }
+        $this->id = $this->ID;
+        $this->name = $this->name();
+        $custom = $this->get_custom();
+        $this->import($custom);
+    }
+
+    /**
+     * @param string $field_name
+     * @return mixed
+     */
+    function get_meta_field($field_name) {
+        $value = null;
+        $value = apply_filters('timber_user_get_meta_field_pre', $value, $this->ID, $field_name, $this);
+        if ( $value === null ) {
+            $value = get_user_meta($this->ID, $field_name, true);
+        }
+        $value = apply_filters('timber_user_get_meta_field', $value, $this->ID, $field_name, $this);
+        return $value;
+    }
+
+    /**
+     * @return array|null
+     */
+    function get_custom() {
+        if ( $this->ID ) {
+            $um = array();
+            $um = apply_filters('timber_user_get_meta_pre', $um, $this->ID, $this);
+            if ( empty($um) ) {
+                $um = get_user_meta($this->ID);
+            }
+            $custom = array();
+            foreach ($um as $key => $value) {
+                if ( is_array($value) && count($value) == 1 ) {
+                    $value = $value[0];
+                }
+                $custom[$key] = maybe_unserialize($value);
+            }
+            $custom = apply_filters('timber_user_get_meta', $custom, $this->ID, $this);
+            return $custom;
+        }
+        return null;
+    }
+
+    /**
+     * @api
+     * @return string http://example.org/author/lincoln
+     */
+    public function link() {
+        if ( !$this->_link ) {
+            $this->_link = untrailingslashit(get_author_posts_url($this->ID));
+        }
+        return $this->_link;
+    }
+
+    /**
+     * @api
+     * @return string the human-friendly name of the user (ex: "Buster Bluth")
+     */
+    function name() {
+        return $this->display_name;
+    }
+
+    /**
+     * @param string $field_name
+     * @return mixed
+     */
+    function meta($field_name) {
+        return $this->get_meta_field($field_name);
+    }
+
+    /**
+     * @api
+     * @return string ex: /author/lincoln
+     */
+    public function path() {
+        return TimberURLHelper::get_rel_url($this->get_link());
+    }
+
+    /**
+     * @api
+     * @return string ex baberaham-lincoln
+     */
+    public function slug() {
+        return $this->user_nicename;
+    }
+
+    /**
+     * @deprecated 0.21.9
+     * @return string The link to a user's profile page
+     */
+    function get_link() {
+        return $this->link();
+    }
+
+    /**
+     * @deprecated 0.21.8
+     * @return string ex: /author/lincoln
+     */
+    function get_path() {
+        return $this->path();
+    }
+
+    /**
+     * @deprecated 0.21.8
+     * @return string
+     */
+    function get_permalink() {
+        return $this->get_link();
+    }
+
+    /**
+     * @deprecated 0.21.8
+     * @return string
+     */
+    function permalink() {
+        return $this->get_permalink();
+    }
 
 }