jarednova / timber

lib/timber-helper.php

Doc Comments +2 added lines, -2 removed lines

@@ -176,7 +176,7 @@ 
 	 *
 	 *
 	 * @param mixed $arg that you want to error_log
-	 * @return void
+	 * @return null|boolean
 	 */
 	public static function error_log( $arg ) {
 		if ( !WP_DEBUG ) {
@@ -208,7 +208,7 @@ 
 	 *
 	 * @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 boolean  $more text to appear in "Read more...". Null to use default, false to hide
 	 * @param string  $allowed_tags
 	 * @return string
 	 */

lib/timber-image-helper.php

Doc Comments +2 added lines, -2 removed lines

@@ -85,7 +85,7 @@ 
 	 * Generates a new image with increased size, for display on Retina screens.
 	 *
 	 * @param string  $src
-	 * @param float   $multiplier
+	 * @param integer   $multiplier
 	 * @param boolean $force
 	 *
 	 * @return string url to the new image
@@ -136,7 +136,7 @@ 
 	 * @param int     $h
 	 * @param string  $color
 	 * @param bool    $force
-	 * @return mixed|null|string
+	 * @return string
 	 */
 	public static function letterbox( $src, $w, $h, $color = '#000000', $force = false ) {
 		$op = new TimberImageOperationLetterbox($w, $h, $color);

Indentation +3 added lines, -3 removed lines

@@ -121,10 +121,10 @@
 		while(!feof($fh) && $count < 2) {
 			$chunk = fread($fh, 1024 * 100); //read 100kb at a time
 			$count += preg_match_all('#\x00\x21\xF9\x04.{4}\x00[\x2C\x21]#s', $chunk, $matches);
-	    }
+		}
 
-	    fclose($fh);
-	    return $count > 1;
+		fclose($fh);
+		return $count > 1;
 	}
 
 	/**

lib/timber-image.php

Doc Comments +1 added lines, -1 removed lines

@@ -301,7 +301,7 @@
 	 * 	   <img src="{{ post.thumbnail.src|resize(500) }}" alt="A sumo wrestler" />
 	 * {% endif %}
 	 * ```
-	 * @return float
+	 * @return integer
 	 */
 	public function aspect() {
 		$w = intval($this->width());

lib/timber-menu-item.php

Doc Comments +1 added lines, -1 removed lines

@@ -149,7 +149,7 @@
 	/**
 	 *
 	 * @internal
-	 * @return bool 
+	 * @return boolean|null 
 	 */
 	function update_child_levels() {
 		if (is_array($this->children)) {

lib/timber-menu.php

Doc Comments +1 added lines, -1 removed lines

@@ -73,7 +73,7 @@
 	public $title;
 
 	/**
-	 * @param int|string $slug
+	 * @param integer $slug
 	 */
 	function __construct($slug = 0) {
 		$locations = get_nav_menu_locations();

lib/timber-post.php

Doc Comments +6 added lines, -6 removed lines

@@ -225,7 +225,7 @@ 
 	/**
 	 * Initializes a TimberPost
 	 * @internal
-	 * @param int|bool $pid
+	 * @param integer $pid
 	 */
 	protected function init($pid = false) {
 		if ( $pid === false ) {
@@ -272,7 +272,7 @@ 
 	 * 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
+	 * @param integer $pid
 	 * @return WP_Post on success
 	 */
 	protected function prepare_post_info( $pid = 0 ) {
@@ -598,7 +598,7 @@ 
 	 * Gets a User object from the author of the post
 	 * @internal
 	 * @see TimberPost::author
-	 * @return bool|TimberUser
+	 * @return TimberUser|null
 	 */
 	function get_author() {
 		if ( isset($this->post_author) ) {
@@ -608,7 +608,7 @@ 
 
 	/**
 	 * @internal
-	 * @return bool|TimberUser
+	 * @return TimberUser|null
 	 */
 	function get_modified_author() {
 		$user_id = get_post_meta($this->ID, '_edit_last', true);
@@ -1073,7 +1073,7 @@ 
 	 *     <a href="{{post.author.link}}">{{post.author.name}}</a>
 	 * </p>
 	 * ```
-	 * @return TimberUser|bool A TimberUser object if found, false if not
+	 * @return TimberUser|null A TimberUser object if found, false if not
 	 */
 	public function author() {
 		return $this->get_author();
@@ -1088,7 +1088,7 @@ 
 	 * ```html
 	 * Last updated by Harper Lee
 	 * ```
-	 * @return TimberUser|bool A TimberUser object if found, false if not
+	 * @return TimberUser|null A TimberUser object if found, false if not
 	 */
 	public function modified_author() {
 		return $this->get_modified_author();

Indentation +4 added lines, -4 removed lines

@@ -231,13 +231,13 @@
 	 	$can_preview = array();
 
 		foreach( $can as $type ) {
-		     if( current_user_can( $type ) ) {
-		        $can_preview[] = true;
-		     }
+			 if( current_user_can( $type ) ) {
+				$can_preview[] = true;
+			 }
 		}
 
 		if ( count( $can_preview ) !== count( $can ) ) {
-		     return;
+			 return;
 		}
 
 		$revisions = wp_get_post_revisions( $query->queried_object_id );

lib/timber-routes.php

Doc Comments +2 added lines, -1 removed lines

@@ -4,6 +4,7 @@ 
 
 	/**
 	 * @deprecated since 0.21.1 use Upstatement/routes instead
+	 * @param Timber $timber
 	 */
 	public static function init( $timber ) {
 		// Install ourselves in Timber
@@ -24,7 +25,7 @@ 
 	 * @param mixed $query
 	 * @param int $status_code
 	 * @param bool $tparams
-	 * @return bool
+	 * @return boolean|null
 	 * @deprecated since 0.21.1 use Upstatement/routes instead
 	 */
 	public static function load_view($template, $query = false, $status_code = 200, $tparams = false) {

lib/timber-url-helper.php

Doc Comments +7 added lines

@@ -136,6 +136,9 @@ 
 		return $path;
 	}
 
+	/**
+	 * @param string $fs
+	 */
 	public static function file_system_to_url( $fs ) {
 		$relative_path = self::get_rel_path( $fs );
 		$home = home_url( '/'.$relative_path );
@@ -210,6 +213,7 @@ 
 	/**
 	 * This will evaluate wheter a URL is at an aboslute location (like http://example.org/whatever)
 	 *
+	 * @param string $path
 	 * @return boolean true if $path is an absolute url, false if relative.
 	 */
 	public static function is_absolute( $path ) {
@@ -230,6 +234,9 @@ 
 		return $is_external;
 	}
 
+	/**
+	 * @param string $url
+	 */
 	private static function is_internal_content($url) {
 		// using content_url() instead of site_url or home_url is IMPORTANT
 		// otherwise you run into errors with sites that:

lib/integrations/acf-timber.php

Indentation +51 added lines, -51 removed lines

@@ -2,57 +2,57 @@
 
 class ACFTimber {
 
-    function __construct() {
-        add_filter( 'timber_post_get_meta', array( $this, 'post_get_meta' ), 10, 2 );
-        add_filter( 'timber_post_get_meta_field', array( $this, 'post_get_meta_field' ), 10, 3 );
-        add_filter( 'timber_term_get_meta', array( $this, 'term_get_meta' ), 10, 3 );
-        add_filter( 'timber_term_get_meta_field', array( $this, 'term_get_meta_field' ), 10, 4 );
-        add_filter( 'timber_user_get_meta_field_pre', array( $this, 'user_get_meta_field' ), 10, 3 );
-        add_filter( 'timber_term_set_meta', array( $this, 'term_set_meta'), 10, 4 );
-    }
-
-    function post_get_meta( $customs, $post_id ) {
-        return $customs;
-    }
-
-    function post_get_meta_field( $value, $post_id, $field_name ) {
-        return get_field( $field_name, $post_id );
-    }
-
-    function term_get_meta_field( $value, $term_id, $field_name, $term ) {
-        $searcher = $term->taxonomy . "_" . $term->ID;
-        return get_field( $field_name, $searcher );
-    }
-
-    function term_set_meta( $value, $field, $term_id, $term ) {
-        $searcher = $term->taxonomy . "_" . $term->ID;
-        update_field( $field, $value, $searcher );
-        return $value;
-    }
-
-    function term_get_meta( $fields, $term_id, $term ) {
-        $searcher = $term->taxonomy . "_" . $term->ID; // save to a specific category
-        $fds = get_fields( $searcher );
-        if ( is_array( $fds ) ) {
-            foreach ( $fds as $key => $value ) {
-                $key = preg_replace( '/_/', '', $key, 1 );
-                $key = str_replace( $searcher, '', $key );
-                $key = preg_replace( '/_/', '', $key, 1 );
-                $field = get_field( $key, $searcher );
-                $fields[$key] = $field;
-            }
-            $fields = array_merge( $fields, $fds );
-        }
-        return $fields;
-    }
-
-    function user_get_meta( $fields, $user_id ) {
-        return $fields;
-    }
-
-    function user_get_meta_field( $value, $uid, $field ) {
-        return get_field( $field, 'user_' . $uid );
-    }
+	function __construct() {
+		add_filter( 'timber_post_get_meta', array( $this, 'post_get_meta' ), 10, 2 );
+		add_filter( 'timber_post_get_meta_field', array( $this, 'post_get_meta_field' ), 10, 3 );
+		add_filter( 'timber_term_get_meta', array( $this, 'term_get_meta' ), 10, 3 );
+		add_filter( 'timber_term_get_meta_field', array( $this, 'term_get_meta_field' ), 10, 4 );
+		add_filter( 'timber_user_get_meta_field_pre', array( $this, 'user_get_meta_field' ), 10, 3 );
+		add_filter( 'timber_term_set_meta', array( $this, 'term_set_meta'), 10, 4 );
+	}
+
+	function post_get_meta( $customs, $post_id ) {
+		return $customs;
+	}
+
+	function post_get_meta_field( $value, $post_id, $field_name ) {
+		return get_field( $field_name, $post_id );
+	}
+
+	function term_get_meta_field( $value, $term_id, $field_name, $term ) {
+		$searcher = $term->taxonomy . "_" . $term->ID;
+		return get_field( $field_name, $searcher );
+	}
+
+	function term_set_meta( $value, $field, $term_id, $term ) {
+		$searcher = $term->taxonomy . "_" . $term->ID;
+		update_field( $field, $value, $searcher );
+		return $value;
+	}
+
+	function term_get_meta( $fields, $term_id, $term ) {
+		$searcher = $term->taxonomy . "_" . $term->ID; // save to a specific category
+		$fds = get_fields( $searcher );
+		if ( is_array( $fds ) ) {
+			foreach ( $fds as $key => $value ) {
+				$key = preg_replace( '/_/', '', $key, 1 );
+				$key = str_replace( $searcher, '', $key );
+				$key = preg_replace( '/_/', '', $key, 1 );
+				$field = get_field( $key, $searcher );
+				$fields[$key] = $field;
+			}
+			$fields = array_merge( $fields, $fds );
+		}
+		return $fields;
+	}
+
+	function user_get_meta( $fields, $user_id ) {
+		return $fields;
+	}
+
+	function user_get_meta_field( $value, $uid, $field ) {
+		return get_field( $field, 'user_' . $uid );
+	}
 }