rousnay / lighthouse

includes/acf/api/api-field.php

Doc Comments +3 added lines

@@ -679,6 +679,9 @@
 *  @return	$fields (array)
 */
 
+/**
+ * @return boolean
+ */
 function acf_get_fields_by_id( $id = 0 ) {
 	
 	// vars

Braces +78 added lines, -26 removed lines

@@ -77,7 +77,9 @@ 
 	
 	
 	// return true if label exists
-	if( $label !== '' ) return true;
+	if( $label !== '' ) {
+		return true;
+	}
 		
 	
 	// return
@@ -102,19 +104,27 @@ 
 function acf_is_field_key( $key = '' ) {
 	
 	// bail early if not string
-	if( !is_string($key) ) return false;
+	if( !is_string($key) ) {
+		return false;
+	}
 	
 	
 	// bail early if is numeric (could be numeric string '123')
-	if( is_numeric($key) ) return false;
+	if( is_numeric($key) ) {
+		return false;
+	}
 	
 	
 	// default - starts with 'field_'
-	if( substr($key, 0, 6) === 'field_' ) return true;
+	if( substr($key, 0, 6) === 'field_' ) {
+		return true;
+	}
 	
 	
 	// special - allow local field key to be any string
-	if( acf_is_local_field($key) ) return true;
+	if( acf_is_local_field($key) ) {
+		return true;
+	}
 	
 	
 	// return
@@ -139,11 +149,15 @@ 
 function acf_get_valid_field( $field = false ) {
 	
 	// $field must be an array
-	if( !is_array($field) ) $field = array();
+	if( !is_array($field) ) {
+		$field = array();
+	}
 	
 	
 	// bail ealry if already valid
-	if( !empty($field['_valid']) ) return $field;
+	if( !empty($field['_valid']) ) {
+		return $field;
+	}
 	
 	
 	// defaults
@@ -211,7 +225,9 @@ 
 function acf_prepare_field( $field ) {
 	
 	// bail early if already prepared
-	if( $field['_input'] ) return $field;
+	if( $field['_input'] ) {
+		return $field;
+	}
 	
 	
 	// _input
@@ -271,11 +287,15 @@ 
 function acf_is_sub_field( $field ) {
 	
 	// local field uses a field instead of ID
-	if( acf_is_field_key($field['parent']) ) return true;
+	if( acf_is_field_key($field['parent']) ) {
+		return true;
+	}
 	
 	
 	// attempt to load parent field
-	if( acf_get_field($field['parent']) ) return true;
+	if( acf_get_field($field['parent']) ) {
+		return true;
+	}
 	
 	
 	// return
@@ -342,7 +362,9 @@ 
 function acf_render_fields( $post_id = 0, $fields, $el = 'div', $instruction = 'label' ) {
 	
 	// bail early if no fields
-	if( empty($fields) ) return false;
+	if( empty($fields) ) {
+		return false;
+	}
 	
 		
 	// remove corrupt fields
@@ -641,7 +663,9 @@ 
 	
 	
 	// bail early if no parent
-	if( !$parent ) return false;
+	if( !$parent ) {
+		return false;
+	}
 	
 	
 	// vars
@@ -686,14 +710,18 @@ 
 	
 	
 	// bail early if no ID
-	if( empty($id) ) return false;
+	if( empty($id) ) {
+		return false;
+	}
 	
 	
 	// cache
 	$found = false;
 	$cache = wp_cache_get( 'get_fields/parent=' . $id, 'acf', false, $found );
 	
-	if( $found ) return $cache;
+	if( $found ) {
+		return $cache;
+	}
 	
 	
 	// args
@@ -787,7 +815,9 @@ 
 		$found = false;
 		$cache = wp_cache_get( $cache_key, 'acf', false, $found );
 		
-		if( $found ) return $cache;
+		if( $found ) {
+			return $cache;
+		}
 		
 	}
 	
@@ -941,7 +971,9 @@ 
 	
 	
 	// bail early if no post_id
-	if( !$post_id ) return false;
+	if( !$post_id ) {
+		return false;
+	}
 		
 	
 	// return
@@ -981,7 +1013,9 @@ 
 	
 	
 	// bail early if no posts
-	if( empty($posts) ) return false;
+	if( empty($posts) ) {
+		return false;
+	}
 	
 	
 	// return
@@ -1050,7 +1084,9 @@ 
 	
 	
 	// bail early if no field
-	if( !$field ) return false;
+	if( !$field ) {
+		return false;
+	}
 	
 	
 	// Override name - allows the $selector to be a sub field (images_0_image)
@@ -1099,7 +1135,9 @@ 
 	
 	
 	// validate
-	if( empty($posts) ) return 0;
+	if( empty($posts) ) {
+		return 0;
+	}
 	
 	
 	// return
@@ -1125,7 +1163,9 @@ 
 function acf_update_field( $field = false, $specific = false ) {
 	
 	// $field must be an array
-	if( !is_array($field) ) return false;
+	if( !is_array($field) ) {
+		return false;
+	}
 	
 	
 	// validate
@@ -1306,7 +1346,9 @@ 
 function acf_duplicate_fields( $fields, $new_parent = 0 ) {
 	
 	// bail early if no fields
-	if( empty($fields) ) return;
+	if( empty($fields) ) {
+		return;
+	}
 	
 	
 	// create new field keys (for conditional logic fixes)
@@ -1482,7 +1524,9 @@ 
 	
 	
 	// bail early if field did not load correctly
-	if( empty($field) ) return false;
+	if( empty($field) ) {
+		return false;
+	}
 	
 	
 	// delete field
@@ -1529,7 +1573,9 @@ 
 	
 	
 	// bail early if field did not load correctly
-	if( empty($field) ) return false;
+	if( empty($field) ) {
+		return false;
+	}
 	
 	
 	// delete field
@@ -1569,7 +1615,9 @@ 
 	
 	
 	// bail early if field did not load correctly
-	if( empty($field) ) return false;
+	if( empty($field) ) {
+		return false;
+	}
 	
 	
 	// delete field
@@ -1601,7 +1649,9 @@ 
 function acf_prepare_fields_for_export( $fields = false ) {
 	
 	// validate
-	if( empty($fields) ) return $fields;
+	if( empty($fields) ) {
+		return $fields;
+	}
 	
 	
 	// format
@@ -1674,7 +1724,9 @@ 
 function acf_prepare_fields_for_import( $fields = false ) {
 	
 	// validate
-	if( empty($fields) ) return $fields;
+	if( empty($fields) ) {
+		return $fields;
+	}
 	
 	
 	// re-index array

includes/acf/api/api-helpers.php

Doc Comments +34 added lines

@@ -13,6 +13,9 @@ 
 *  @return	(mixed)
 */
 
+/**
+ * @param string $name
+ */
 function acf_get_setting( $name, $default = null ) {
 	
 	// vars
@@ -46,6 +49,9 @@ 
 *  @return	(boolean)
 */
 
+/**
+ * @param string $name
+ */
 function acf_get_compatibility( $name ) {
 	
 	return apply_filters( "acf/compatibility/{$name}", false );
@@ -67,6 +73,9 @@ 
 *  @return	n/a
 */
 
+/**
+ * @param string $name
+ */
 function acf_update_setting( $name, $value ) {
 	
 	acf()->settings[ $name ] = $value;
@@ -88,6 +97,10 @@ 
 *  @return	n/a
 */
 
+/**
+ * @param string $name
+ * @param string $value
+ */
 function acf_append_setting( $name, $value ) {
 	
 	// createa array if needed
@@ -116,6 +129,9 @@ 
 *  @return	(boolean)
 */
 
+/**
+ * @param string $name
+ */
 function acf_has_done( $name ) {
 	
 	// vars
@@ -189,6 +205,9 @@ 
 *  @return	$post_id (int)
 */
 
+/**
+ * @param string $file
+ */
 function acf_include( $file ) {
 	
 	$path = acf_get_path( $file );
@@ -523,6 +542,9 @@ 
 *  @return	(mixed)
 */
 
+/**
+ * @param string $default
+ */
 function acf_extract_var( &$array, $key, $default = null ) {
 	
 	// check if exists
@@ -560,6 +582,9 @@ 
 *  @return	$post_id (int)
 */
 
+/**
+ * @param string[] $keys
+ */
 function acf_extract_vars( &$array, $keys ) {
 	
 	$r = array();
@@ -713,6 +738,9 @@ 
 *  @return	(boolean)
 */
 
+/**
+ * @param string $value
+ */
 function acf_verify_nonce( $value, $post_id = 0 ) {
 	
 	// vars
@@ -1903,6 +1931,9 @@ 
 *  @return	(boolean)
 */
 
+/**
+ * @param string $needle
+ */
 function acf_str_exists( $needle, $haystack ) {
 	
 	// return true if $haystack contains the $needle
@@ -2376,6 +2407,9 @@ 
 *  @return	$post_id (int)
 */
 
+/**
+ * @return string
+ */
 function acf_get_user_setting( $name = '', $default = false ) {
 	
 	// get current user id

Braces +26 added lines, -10 removed lines

@@ -123,7 +123,9 @@ 
 	
 	
 	// return true if already done
-	if( acf_get_setting($setting) ) return true;
+	if( acf_get_setting($setting) ) {
+		return true;
+	}
 	
 	
 	// update setting
@@ -1105,7 +1107,9 @@ 
 		
 		
 		// bail early i no terms
-		if( empty($terms) ) continue;
+		if( empty($terms) ) {
+			continue;
+		}
 		
 		
 		// sort into hierachial order!
@@ -1957,7 +1961,7 @@ 
 				
 				$arg = $arg ? 'true' : 'false';
 				
-			}elseif( is_string($arg) ) {
+			} elseif( is_string($arg) ) {
 				
 				$arg = '"' . $arg . '"';
 				
@@ -3342,7 +3346,7 @@ 
 				// min height
 				$errors['min_height'] = sprintf(__('Image height must be at least %dpx.', 'acf'), $min_height );
 				
-			}  elseif( $max_height && $file['height'] > $max_height ) {
+			} elseif( $max_height && $file['height'] > $max_height ) {
 				
 				// min height
 				$errors['max_height'] = sprintf(__('Image height must not exceed %dpx.', 'acf'), $max_height );
@@ -3468,14 +3472,18 @@ 
 function acf_translate_keys( $array, $keys ) {
 	
 	// bail early if no keys
-	if( empty($keys) ) return $array;
+	if( empty($keys) ) {
+		return $array;
+	}
 	
 	
 	// translate
 	foreach( $keys as $k ) {
 		
 		// bail ealry if not exists
-		if( !isset($array[ $k ]) ) continue;
+		if( !isset($array[ $k ]) ) {
+			continue;
+		}
 		
 		
 		// translate
@@ -3507,11 +3515,15 @@ 
 function acf_translate( $string ) {
 	
 	// bail early if not enabled
-	if( !acf_get_setting('l10n') ) return $string;
+	if( !acf_get_setting('l10n') ) {
+		return $string;
+	}
 	
 	
 	// bail early if no textdomain
-	if( !acf_get_setting('l10n_textdomain') ) return $string;
+	if( !acf_get_setting('l10n_textdomain') ) {
+		return $string;
+	}
 	
 	
 	// is array
@@ -3523,11 +3535,15 @@ 
 	
 	
 	// bail early if not string
-	if( !is_string($string) ) return $string;
+	if( !is_string($string) ) {
+		return $string;
+	}
 	
 	
 	// bail early if empty
-	if( $string === '' ) return $string;
+	if( $string === '' ) {
+		return $string;
+	}
 	
 	
 	// allow for var_export export

includes/acf/api/api-template.php

Doc Comments +6 added lines

@@ -15,6 +15,9 @@ 
 *  @return	$reference (string)	a string containing the field_key
 */
 
+/**
+ * @return string
+ */
 function acf_get_field_reference( $field_name, $post_id ) {
 	
 	// try cache
@@ -857,6 +860,9 @@ 
 *  @return	(array)	
 */
 
+/**
+ * @param string $selector
+ */
 function get_sub_field_object( $selector, $format_value = true, $load_value = true ) {
 	
 	// vars

Braces +7 added lines, -4 removed lines

@@ -654,7 +654,9 @@ 
 	
 	
 	// bail early if no row
-	if( !$row ) return 0;
+	if( !$row ) {
+		return 0;
+	}
 	
 	
 	// return
@@ -683,8 +685,7 @@ 
 	if( $hard_reset )
 	{
 		$GLOBALS['acf_field'] = array();
-	}
-	else
+	} else
 	{
 		// vars
 		$depth = count( $GLOBALS['acf_field'] ) - 1;
@@ -1749,7 +1750,9 @@ 
 	
 	
 	// bail early if no field
-	if( !$field ) return false;
+	if( !$field ) {
+		return false;
+	}
 	
 	
 	// update sub fields

includes/acf/forms/user.php

Doc Comments +3 added lines

@@ -207,6 +207,9 @@
 	*  @return	n/a
 	*/
 	
+	/**
+	 * @param string $user_form
+	 */
 	function render( $user_id, $user_form, $el = 'tr' ) {
 		
 		// vars

Braces +5 added lines, -2 removed lines

@@ -324,13 +324,16 @@
     width: 100%;
 }
 
-<?php else: ?>
+<?php else {
+	: ?>
 
 #registerform p.submit {
 	text-align: right;
 }
 
-<?php endif; ?>
+<?php endif;
+}
+?>
 
 </style>
 <script type="text/javascript">

includes/acf/pro/api/api-pro.php

Doc Comments +3 added lines

@@ -72,6 +72,9 @@
 *  @return	$post_id (int)
 */
 
+/**
+ * @return string
+ */
 function acf_pro_get_remote_response( $action = '', $post = array() ) {
 	
 	// vars

includes/acf/acf.php

Braces +10 added lines, -3 removed lines

@@ -11,7 +11,10 @@ 
 Domain Path: /lang
 */
 
-if( ! defined( 'ABSPATH' ) ) exit; // Exit if accessed directly
+if( ! defined( 'ABSPATH' ) ) {
+	exit;
+}
+// Exit if accessed directly
 
 if( ! class_exists('acf') ) :
 
@@ -168,11 +171,15 @@ 
 	function init() {
 		
 		// bail early if a plugin called get_field early
-		if( !did_action('plugins_loaded') ) return;
+		if( !did_action('plugins_loaded') ) {
+			return;
+		}
 		
 		
 		// bail early if already init
-		if( acf_get_setting('init') ) return;
+		if( acf_get_setting('init') ) {
+			return;
+		}
 		
 		
 		// only run once

includes/acf/admin/settings-addons.php

Braces +1 added lines, -2 removed lines

@@ -85,8 +85,7 @@
         if( is_wp_error($request) || wp_remote_retrieve_response_code($request) != 200)
         {
         	acf_add_admin_notice(__('<b>Error</b>. Could not load add-ons list', 'acf'), 'error');
-        }
-        else
+        } else
         {
 	        $this->view['json'] = json_decode( $request['body'], true );
         }

includes/acf/admin/settings-tools.php

Braces +3 added lines, -1 removed lines

@@ -436,7 +436,9 @@
 			
 			
 			// validate field group
-			if( empty($field_group) ) continue;
+			if( empty($field_group) ) {
+				continue;
+			}
 			
 			
 			// load fields

includes/acf/admin/updates/5.0.0.php

Braces +3 added lines, -1 removed lines

@@ -12,7 +12,9 @@
 */
 
 // Exit if accessed directly
-if( !defined('ABSPATH') ) exit;
+if( !defined('ABSPATH') ) {
+	exit;
+}
 
 
 // global