cnp/php-utilities

Generic PHP functions for standardized data manipulation.

PHP-Utilities

Generic PHP functions for data manipulation., _(*1)

Functions

getAcfFieldsAsArray

Gets a bunch of specific ACF fields at once. Especially useful for option page settings, which only have a way to get one field at a time., _(*2)

Parameters

$fields_names_arr (array|required): An array of the field names., _(*3)

$option (boolean|optional): Set to true if the fields are from an options page., _(*4)

Return Values

$data_arr (array): Data array keyed to the field names from the input array., _(*5)

multidimensionalArrayMap

Like array_map, but for multidimensional arrays., _(*6)

Parameters

$function The callback function to apply to each value of the array, _(*7)

$array The multi-dimensional array, _(*8)

Return Values

(array) The formatted array., _(*9)

parseClassesAsArray

Take a string or array of classes, trim them and then return classes as an array., _(*10)

Parameters

$classes (required): An flat array or comma-delimited string of classes., _(*11)

Return Values

(boolean or array) If the formatted array is empty, returns false. Otherwise, returns array of classes., _(*12)

printOnPresent

Like the proverbial weasel, this function pops out markup if data is present. It's a more efficient way of doing an if ( '' !== $data ) or if ( !empty( $data ) ) check: 3 lines for the price of one!, _(*13)

If you pass in a function name, the function will be executed. You can use anonymous functions too!, _(*14)

Usage

<?php CNP\Utility::printOnPresent( $string, '<h1 class="title">'. $string .'</h1>' ); ?>

Parameters

$string_or_array (required): The variable to check for data, which can be a string or an array. Objects are not supported., _(*15)

$markup_or_function (required): What to do with the data if it is present. You can supply a string of markup, or call a function for more complex scenarios., _(*16)

Return Values

(boolean or string) If the data check fails, printOnPresent returns false. If the data check is successful, then printOnPresent echoes the markup or function output from the $markup_or_function variable., _(*17)