%PDF-
%PDF-
Mini Shell
Mini Shell
<?php
namespace AC\Helper;
class Strings {
/**
* @param $url
*
* @return bool|false|string
* @since 1.3.1
*/
public function shorten_url( $url ) {
if ( ! $url ) {
return false;
}
return ac_helper()->html->link( $url, url_shorten( $url ), [ 'title' => $url ] );
}
/**
* @param $string
*
* @return string
* @since 1.3
*/
public function strip_trim( $string ) {
return trim( strip_tags( $string ) );
}
/**
* @param string $content
*
* @return array
*/
public function get_shortcodes( $content ) {
global $shortcode_tags;
if ( ! $shortcode_tags || ! $content ) {
return [];
}
$shortcodes = [];
$_shortcodes = array_keys( $shortcode_tags );
asort( $_shortcodes );
foreach ( $_shortcodes as $shortcode ) {
$count = substr_count( $content, '[' . $shortcode . ']' );
$count += substr_count( $content, '[' . $shortcode . ' ' );
if ( $count ) {
$shortcodes[ $shortcode ] = $count;
}
}
return $shortcodes;
}
/**
* Count the number of words in a string (multibyte-compatible)
*
* @param $string
*
* @return int Number of words
* @since 3.0
*/
public function word_count( $string ) {
if ( empty( $string ) ) {
return false;
}
$string = $this->strip_trim( $string );
if ( empty( $string ) ) {
return false;
}
$patterns = [
'strip' => '/<[a-zA-Z\/][^<>]*>/',
'clean' => '/[0-9.(),;:!?%#$¿\'"_+=\\/-]+/',
'w' => '/\S\s+/',
'c' => '/\S/',
];
$string = preg_replace( $patterns['strip'], ' ', $string );
$string = preg_replace( '/ | /i', ' ', $string );
$string = preg_replace( $patterns['clean'], '', $string );
if ( ! strlen( preg_replace( '/\s/', '', $string ) ) ) {
return 0;
}
return preg_match_all( $patterns['w'], $string, $matches ) + 1;
}
/**
* @param string $string
* @param int $num_words
* @param null $more
*
* @return false|string
* @see wp_trim_words();
* @since 3.0
*/
public function trim_words( $string = '', $num_words = 30, $more = null ) {
if ( $this->is_empty( $string ) ) {
return false;
}
if ( ! $num_words ) {
return $string;
}
return wp_trim_words( $string, $num_words, $more );
}
/**
* Trims a string and strips tags if there is any HTML
*
* @param string $string
* @param int $limit
* @param null $trail
*
* @return string
*/
public function trim_characters( $string, $limit = 10, $trail = null ) {
$limit = absint( $limit );
if ( 1 > $limit ) {
return $string;
}
$string = wp_strip_all_tags( $string );
if ( mb_strlen( $string ) <= $limit ) {
return $string;
}
if ( null === $trail ) {
$trail = __( '…' );
}
return mb_substr( $string, 0, $limit ) . $trail;
}
/**
* Formats a valid hex color to a 6 digit string, optionally prefixed with a #
* Example: #FF0 will be fff000 based on the $prefix parameter
*
* @param string $hex Valid hex color
* @param bool $prefix Prefix with a # or not
*
* @return string
*/
protected function hex_format( $hex, $prefix = false ) {
$hex = ltrim( $hex, '#' );
if ( strlen( $hex ) == 3 ) {
$hex = $hex[0] . $hex[0] . $hex[1] . $hex[1] . $hex[2] . $hex[2];
}
if ( $prefix ) {
$hex = '#' . $hex;
}
return strtolower( $hex );
}
/**
* Get RGB values from a hex color string
*
* @param string $hex Valid hex color
*
* @return array
* @since 3.0
*/
public function hex_to_rgb( $hex ) {
$hex = $this->hex_format( $hex );
return sscanf( $hex, '%2x%2x%2x' );
}
/**
* Get contrasting hex color based on given hex color
*
* @param string $hex Valid hex color
*
* @return string
* @since 3.0
*/
public function hex_get_contrast( $hex ) {
$rgb = $this->hex_to_rgb( $hex );
$contrast = ( $rgb[0] * 0.299 + $rgb[1] * 0.587 + $rgb[2] * 0.114 ) < 186 ? 'fff' : '333';
return $this->hex_format( $contrast, true );
}
/**
* @param string $url
*
* @return bool
* @since 1.2.0
*/
public function is_image( $url ) {
if ( ! $url || ! is_string( $url ) ) {
return false;
}
$ext = strtolower( pathinfo( strtok( $url, '?' ), PATHINFO_EXTENSION ) );
return in_array( $ext, [ 'jpg', 'jpeg', 'gif', 'png', 'bmp' ] );
}
/**
* @param string $string
*
* @return array
* @since 3.0
*/
public function comma_separated_to_array( $string ) {
$array = [];
if ( is_scalar( $string ) ) {
if ( strpos( $string, ',' ) !== false ) {
$array = array_filter( explode( ',', ac_helper()->string->strip_trim( str_replace( ' ', '', $string ) ) ) );
} else {
$array = [ $string ];
}
} else if ( is_array( $string ) ) {
$array = $string;
}
return $array;
}
/**
* @param string $string
*
* @return array
* @since 3.0
*/
public function string_to_array_integers( $string ) {
$integers = [];
foreach ( $this->comma_separated_to_array( $string ) as $k => $value ) {
if ( is_numeric( trim( $value ) ) ) {
$integers[] = $value;
}
}
return $integers;
}
/**
* @param string $hex Color Hex Code
*
* @return string
* @since 3.0
*/
public function get_color_block( $hex ) {
if ( ! $hex ) {
return false;
}
return '<div class="cpac-color"><span style="background-color:' . esc_attr( $hex ) . ';color:' . esc_attr( $this->hex_get_contrast( $hex ) ) . '">' . esc_html( $hex ) . '</span></div>';
}
/**
* @param $url
*
* @return bool
*/
public function is_valid_url( $url ) {
return filter_var( $url, FILTER_VALIDATE_URL ) || preg_match( '/[^\w.-]/', $url );
}
/**
* @return string Display empty value
*/
public function get_empty_char() {
_deprecated_function( __METHOD__, '3.0', 'AC\Column::get_empty_char' );
return '–';
}
/**
* @param string $string
*
* @return bool
*/
public function contains_html_only( $string ) {
return strlen( $string ) !== strlen( strip_tags( $string ) );
}
/**
* @param string $value
*
* @return bool
*/
public function is_empty( $value ) {
return ! $this->is_not_empty( $value );
}
/**
* @param string $value
*
* @return bool
*/
public function is_not_empty( $value ) {
return $value || 0 === $value || '0' === $value;
}
/**
* Return an array into a comma separated sentence. For example [minute, hours, days] becomes: "minute, hours or days".
*
* @param array $words
* @param string $compound
*
* @return string
*/
public function enumeration_list( $words, $compound = 'or' ) {
if ( empty( $words ) || ! is_array( $words ) ) {
return false;
}
if ( 'and' === $compound ) {
return wp_sprintf( '%l', $words );
}
if ( 'or' === $compound ) {
$compound = __( ' or ', 'codepress-admin-columns' );
}
$compound = sprintf( ' %s ', trim( $compound ) );
$last = end( $words );
$delimiter = ', ';
return str_replace( $delimiter . $last, $compound . $last, implode( $delimiter, $words ) );
}
}
Zerion Mini Shell 1.0