\n" );
return $form_fields;
}
/**
* Add a post parameter to swfupload
* @param array $params
*/
function FA_swfupload_post_param($params){
// check if FA Lite initiated the upload
if( !isset( $_GET['edit-falite'] ) ) return $params;
// set a post param to know whe're uploading an image for FA Lite
$params['edit_falite'] = 1;
/*
* if short param is set, after upload async-upload returns only the image id and a new AJAX request will be made for the actual content.
* If it isn't set, it will return directly the HTML and POST variable will be available.
*/
$params['short'] = 0;
return $params;
}
// pre Wordpress 3.3 filter
add_filter('swfupload_post_params', 'FA_swfupload_post_param', 15, 1);
// Wordpress 3.3 filter
add_filter('upload_post_params', 'FA_swfupload_post_param', 15, 1);
/**
* Check if variables are set on link to change the Add to post button into what we need.
* Post variable comes from SWF upload as it is set in FA_swfupload_post_param() function.
* Pay attention to short param, see description on function mentioned above.
*/
function FA_check_upload(){
/**
* get variable is set when opening the modal window
* post variable is sent to swfupload and returned by it
*/
if( isset( $_GET['edit-falite'] ) || isset($_POST['edit_falite']) ){
add_filter('attachment_fields_to_edit', 'attachment_fields', 10, 2 );
}
// add the script needed to place the image as featured
global $pagenow;
if( $pagenow == 'media-upload.php' ){
wp_enqueue_script('FA_cust_image', FA_path('scripts/custom_image.js', array('jquery')));
}
}
add_action('admin_init', 'FA_check_upload');
/**
* Needed for the browser upload version to add the GET param on form link
* @param string $url
*/
function FA_hijack_upload($url){
if( strstr($url, 'media-upload.php') && isset($_GET['edit-falite']) ){
$url.='&edit-falite=1';
}
return $url;
}
add_filter('admin_url', 'FA_hijack_upload');
/**
* AJAX request response to set image as featured
*/
function FA_set_post_image(){
$post_ID = intval( $_POST['post_id'] );
if ( !current_user_can( 'edit_post', $post_ID ) )
die( '-1' );
$thumbnail_id = intval( $_POST['thumbnail_id'] );
check_ajax_referer( "fa_cust_image" );
update_post_meta( $post_ID, '_fa_image', $thumbnail_id );
$th = wp_get_attachment_image_src( $thumbnail_id, 'thumbnail' );
die($th[0]);
}
add_action('wp_ajax_FA-post-thumbnail', 'FA_set_post_image');
/**
* Ajax call for removing a post image
*/
function FA_remove_post_image(){
$post_ID = intval( $_POST['post_id'] );
if ( !current_user_can( 'edit_post', $post_ID ) )
die( '-1' );
check_ajax_referer( "featured-articles-post-image-remove" );
delete_post_meta( $post_ID, '_fa_image');
die('1');
}
add_action('wp_ajax_FA-remove-post-thumbnail', 'FA_remove_post_image');
/**
* Creates a hidden input in media gallery search and filter form to allow
* searches to keep the variable that forces the FA link.
*
* @since 2.4.1
*/
function FA_media_forms_set_var( $links_arr ){
if( !isset( $_GET['edit-falite'] ) ) return $links_arr;
$links_arr[] ='';
return $links_arr;
}
add_filter('media_upload_mime_type_links', 'FA_media_forms_set_var', 1, 10);
/**
* Returns the complete path of a given file from within the plugin
*
* @param string $file
* @return string
*/
function FA_path( $file ){
if( !defined('FA_PLUGIN_URL') ){
define('FA_PLUGIN_URL', WP_PLUGIN_URL.'/featured-articles-lite/');
}
return FA_PLUGIN_URL.$file;
}
/**
* Returns complete path of a file within the plugin
*
* @param string $file
* @return string
*/
function FA_dir( $file ){
if( !defined('FA_PLUGIN_DIR') ){
define('FA_PLUGIN_DIR', WP_PLUGIN_DIR.'/featured-articles-lite/');
}
return FA_PLUGIN_DIR.$file;
}
/**
* Truncates a text on a given number of characters. Based on the Smarty plugin
*
* @param string $string
* @param int $length
* @param string $etc
* @param bool $break_words
* @param bool $middle
* @return string
*/
function FA_truncate_text($string, $length = 80, $etc = '...', $break_words = false, $middle = false){
if ($length == 0)
return '';
if (strlen($string) > $length) {
$length -= strlen($etc);
if (!$break_words && !$middle) {
$string = preg_replace('/\s+?(\S+)?$/', '', substr($string, 0, $length+1));
}
if(!$middle) {
return substr($string, 0, $length).$etc;
} else {
return substr($string, 0, $length/2) . $etc . substr($string, -$length/2);
}
} else {
return $string;
}
}
/**
* Truncates a text containing HTML markup. Closes all tags that remain opened after trucncating to a given text length
* @param string $string
* @param int $length
* @param string $ending
*/
function FA_truncate_html($string, $length = 80, $ending = '...'){
// if text without HTML is smaller than length, return the whole text
if (strlen(preg_replace('/<.*?>/', '', $string)) <= $length) {
return $string;
}
$truncated = '';
$total_length = strlen($ending);
$opened = array();
$auto_closed = array('img','br','input','hr','area','base','basefont','col','frame','isindex','link','meta','param');
preg_match_all('/(<\/?([\w+]+)[^>]*>)?([^<>]*)/', $string, $tags, PREG_SET_ORDER);
foreach( $tags as $tag ){
$tag_name = strtolower($tag[2]);
if( !in_array($tag_name, $auto_closed) ){
if (preg_match('/<[\w]+[^>]*>/s', $tag[0])) {
array_unshift($opened, $tag[2]);
} else if (preg_match('/<\/([\w]+)[^>]*>/s', $tag[0], $closeTag)) {
$pos = array_search($closeTag[1], $opened);
if ($pos !== false) {
array_splice($opened, $pos, 1);
}
}
}
// if empty, it's plain text
if( !empty($tag[2]) )
$truncated.=$tag[1];
// calculate string length
$string_length = strlen($tag[3]);
if( $total_length + $string_length <= $length ){
$truncated.=$tag[3];
$total_length+=$string_length;
}else{
if( $total_length == 0 ){
$truncated.= substr($tag[3], 0, $length).$ending;
break;
}
$diff = $length - $total_length;
$truncated.= substr($tag[3], 0, $diff).$ending;
break;
}
}
// close all opened tags
foreach ($opened as $tag) {
$truncated .= '';
}
return $truncated;
}
/**
* Returns the maximum size in pixels for a given size name
* @param string $size
*/
function FA_image_size_pixels($size){
global $_wp_additional_image_sizes;
if ( $size == 'thumb' || $size == 'thumbnail' ) {
$max_width = intval(get_option('thumbnail_size_w'));
$max_height = intval(get_option('thumbnail_size_h'));
if ( !$max_width && !$max_height ) {
$max_width = 128;
$max_height = 96;
}
}
elseif ( $size == 'medium' ) {
$max_width = intval(get_option('medium_size_w'));
$max_height = intval(get_option('medium_size_h'));
}
elseif ( $size == 'large' ) {
$max_width = intval(get_option('large_size_w'));
$max_height = intval(get_option('large_size_h'));
} elseif ( isset( $_wp_additional_image_sizes ) && count( $_wp_additional_image_sizes ) && in_array( $size, array_keys( $_wp_additional_image_sizes ) ) ) {
$max_width = intval( $_wp_additional_image_sizes[$size]['width'] );
$max_height = intval( $_wp_additional_image_sizes[$size]['height'] );
}
if( isset($max_width) && isset($max_height) ){
return array('w'=>$max_width, 'h'=>$max_height);
}
// $size == 'full' has no constraint
else {
return array();
}
}
/**
* Returns the image path set in meta field for a post or page
* @param int $post_id
* @param string $meta_field
* @param string/array $size
*/
function FA_get_meta_image($post_id, $meta_field, $size){
$meta_image_id = get_post_meta($post_id, $meta_field, true);
$meta_image = wp_get_attachment_image_src( $meta_image_id, $size );
return $meta_image;
}
/**
* Scan given content for images and try to detect image id from database.
* Returns an array with keys img and id. If image path is detected, img key will hold that value.
* If image id can be detected, id key will hold that value
* @param HTML string $content
* @param string/array $size
*/
function FA_scan_image($content, $size = 'thumbnail'){
// check for images in text
preg_match_all("#\]+)\>#Ui", $content, $matches);
// no image is available
if( !isset($matches[0][0]) ){
return false;
}
$result = array('img'=>false, 'id'=>false);
// get image attributes in order to determine the attachment guid
preg_match_all("#([a-z]+)=\"(.*)\"#Ui", $matches[0][0], $attrs);
$inversed = array_flip($attrs[1]);
// if image doesn't have width/height attributes set on it, there's no point in going further
if( !array_key_exists('width', $inversed) || !array_key_exists('height', $inversed) ){
$result['img'] = $matches[3][0];
return $result;
}
// image attributes hold the image URL. Replace those to get the real image guid
$img_size_url = '-'.$attrs[2][$inversed['width']].'x'.$attrs[2][$inversed['height']];
$real_image_guid = str_replace( $img_size_url, '', $matches[3][0] );
global $wpdb;
$the_image = $wpdb->get_row( $wpdb->prepare( "SELECT * FROM $wpdb->posts WHERE guid = '$real_image_guid' AND post_type='attachment'" ) );
// if unsuccessful, return the image url from content
if( !$the_image ){
$result['img'] = $matches[3][0];
}else{
$meta_image = wp_get_attachment_image_src( $the_image->ID, $size );
if( $meta_image ){
// if meta image was found, set the id as custom field for the post so that all the query work won't be needed again
$result['id'] = $the_image->ID;
$result['img'] = $meta_image[0];
}else{
$result['img'] = $matches[3][0];
}
}
return $result;
}
/**
* Image detection inside post
*
* @param object $post
* @param int $slider_id
* @param string $other_size - by default, function gets the image size from slideshow options. If other size is needed, value from $other_size will overwrite slideshow option value
* @param bool $return_path - returns image url(true) or array(false) containing image url, width and height
*
* @return string - image path
*/
function FA_article_image ($post, $slider_id, $other_size = false, $return_path = true){
// if thumbnails are stopped from admin, return false
$options = FA_get_option('_fa_lite_aspect');
if( !$options['thumbnail_display'] )
return false;
$image_size = $other_size ? $other_size : $options['th_size'];
// check for custom field image
$meta_image = FA_get_meta_image($post->ID, '_fa_image', $image_size);
if( $meta_image ){
return $return_path ? $meta_image[0] : $meta_image;
}
// check for post thumbnail
if( current_theme_supports('post-thumbnails') ){
$meta_image = FA_get_meta_image($post->ID, '_thumbnail_id', $image_size);
if( $meta_image ){
return $return_path ? $meta_image[0] : $meta_image;
}
}
// check for auto detected images
$meta_image = FA_get_meta_image($post->ID, '_fa_image_autodetect', $image_size);
if( $meta_image ){
return $return_path ? $meta_image[0] : $meta_image;
}
// if none of the meta keys is set, try to auto detect image in post content
$image = FA_scan_image($post->post_content, $image_size);
if( !$image['img'] )
return false;
if( $image['id'] ){
update_post_meta($post->ID, '_fa_image_autodetect', $image['id']);
if( !$return_path ){
$meta_image = wp_get_attachment_image_src($image['id'], $image_size);
return $meta_image;
}
}
// if only path should be returned, do it
if( $return_path ){
return $image['img'];
}else{ // return array. Should contain width and height of image so set them to auto
return array($image['img'], false, false);
}
}
/**
* For image autodetection, scan post text to save the image on save_post action.
*/
function FA_check_autoimg_update($post_id){
$meta_key = get_post_meta($post_id, '_fa_image_autodetect', true);
if(!$meta_key) return;
$post = get_post($post_id);
$image = FA_scan_image($post->post_content);
if( $image['id'] ){
update_post_meta($post_id, '_fa_image_autodetect', $image['id']);
}else{
delete_post_meta($post_id, '_fa_image_autodetect');
}
}
add_action('save_post', 'FA_check_autoimg_update');
/**
* Reads a given folder and returns the files list
* @param string $path
* @param array $exclude
*/
function FA_read_dir( $path, $exclude = array() ){
$result = array();
if( !is_dir($path) ) return $result;
$not = array('.', '..');
$exclude = array_merge($exclude, $not);
if ($handle = opendir( $path )) {
while (false !== ($file = readdir($handle))) {
if( in_array($file, $exclude) || substr($file, 0, 1) == '.' || substr($file, 0, 1) == '_' ) continue;
$result[] = $file;
}
}
return $result;
}
/**
* Returns an array of available themes. Also, can return themes from a different
* folder (if provided). This second option is used when user tries to modify
* default themes folder from within plugin settings in Wordpress admin
*
* @since 2.4 - modified in 2.4.1
*/
function FA_themes( $new_path = false ){
/**
* If new path is given, read it for the themes.
* This is used to check if user copied themes files into new folder before trying to change themes folder path.
*/
if( $new_path ){
$themes_dir_full_path = WP_CONTENT_DIR.'/'.$new_path;
$themes_dir_full_url = WP_CONTENT_URL.'/'.$new_path;
}else{// let's look inside the default folder
$themes_dir_full_path = FA_themes_path();
$themes_dir_full_url = FA_themes_url();
}
$theme_folders = FA_read_dir( $themes_dir_full_path );
// will store all themes details
$themes = array();
foreach ($theme_folders as $theme){
// theme path and URL
$theme_path = $themes_dir_full_path.'/'.$theme;
$theme_url = $themes_dir_full_url.'/'.$theme;
// default theme information
$default_headers = array(
'Author' =>'',
'AuthorURI' =>'',
'Copyright' =>'',
'Fields' => array(),
'Image' =>'',
'Message' =>''
);
// filter theme details. This way themes can add their own information.
$theme_details = apply_filters('fa-theme-details-'.$theme, $default_headers);
// theme should have a display.php file. If it doesn't, skip it.
$display_file = $theme_path.'/display.php';
if( !is_file( $display_file ) ){
continue; // stop processing this theme. It doesn't have a display.php file
}
// merge filtered array with defaults and put it into theme config key
$themes[$theme]['theme_config'] = wp_parse_args($theme_details, $default_headers);;
// let's see if theme has preview image
$preview_image = $theme_path.'/preview.jpg';
if( is_file($preview_image) ){
$themes[$theme]['preview'] = $theme_url.'/preview.jpg';
}else{
$themes[$theme]['preview'] = 0;
}
// next, check for functions file
$functions_file = $theme_path.'/functions.php';
if( is_file($functions_file) ){
$themes[$theme]['funcs'] = $functions_file;
}else{
$themes[$theme]['funcs'] = false;
}
// last, check colors stylesheets
$colors_path = $theme_path.'/colors/';
$colors = FA_read_dir( $colors_path );
$themes[$theme]['colors'] = $colors;
}
return $themes;
}
/**
* Themes backwards compatibility function. Based on theme name passed to it,
* if theme is old dark or old light, verifies the existance of the themes.
*
* If dark of light is set, it will return an array with classic theme and appropriate
* color stylesheet for it.
*
* @param string $theme - theme name
* @return bool
* @since 2.4.2
*/
function FA_should_load_classic( $theme ){
if( 'dark' == $theme || 'light' == $theme ){
$check_theme_path = FA_theme_path($theme);// verifies folder existance
// theme dark or light doesn't exist. Switch to classic
if( !$check_theme_path ){
$result = array(
'active_theme' => 'classic',
'active_theme_color' => $theme.'.css'
);
return $result;
}
}
return false;
}
/***********************************************************************************************
* Slideshow theme template functions
***********************************************************************************************/
/**
* Echoes the current item image. Shorthand for do_the_fa_image
* @param string $before
* @param string $after
*/
function the_fa_image( $before = '
', $after = '
' ){
global $FA_slider_options;
$image = do_the_fa_image($before, $after, $FA_slider_options['_fa_lite_aspect']['thumbnail_click']);
if( $image )
echo $image;
}
/**
* Template function for displaying the image
* @param string $image
* @param string $before
* @param string $after
* @param bool $echo
*/
function do_the_fa_image($before = '', $after = '', $clickable = false) {
// use the global $post since it's set by our loop and the original post gets restored after slider is displayed
global $post;
if( !$post || (!isset($post->FA_image) || empty($post->FA_image) ) ) return;
// assume not link on image
$link_open = '';
$link_close = '';
// set opening and closing tags for image link
if( $clickable ){
$link_open = sprintf(
'',
get_permalink($post->ID),
$post->post_title,
$post->link_target
);
$link_close = '';
}
$width = $post->FA_image[1] ? 'width="'.$post->FA_image[1].'"' : '';
$height = $post->FA_image[2] ? 'height="'.$post->FA_image[2].'"' : '';
// add link to image if any
$image_html = sprintf(
'%1$s%5$s',
$link_open,
$post->FA_image[0],
$width,
$height,
$link_close
);
return $before . $image_html . $after;
}
/**
* Echoes the title. Shorthand for do_the_fa_title
* @param string $before
* @param string $after
*/
function the_fa_title( $before = '', $after = ''){
global $FA_slider_options;
if( !$FA_slider_options['_fa_lite_aspect']['show_title'] ){
return;
}
$title = do_the_fa_title($before, $after, $FA_slider_options['_fa_lite_aspect']['title_click']);
if( $title )
echo $title;
}
/**
* Template function to display the slide title. Also adds link if set in options
* @param string $before
* @param string $after
* @param bool $clickable
* @param bool $echo
*/
function do_the_fa_title( $before = '', $after = '', $clickable = false ){
// use the global $post since it's set by our loop and the original post gets restored after slider is displayed
global $post;
if( !$post ) return;
// not wrapped in link
$link_open = '';
$link_close = '';
// wrap in link if set
if( $clickable ){
$link_open = sprintf('', get_permalink($post->ID), $post->post_title, $post->link_target);
$link_close = '';
}
// put it all in one var
// run filters on title to enable plugins like qTranslate to return the correct title
$title_html = $link_open . apply_filters('the_title', $post->post_title) . $link_close;
return $before . $title_html . $after;
}
/**
* Echoes the post content. Shorthand for do_the_fa_content
* @param string $before
* @param string $after
*/
function the_fa_content( $before = '', $after = '' ){
global $FA_slider_options;
if( !$FA_slider_options['_fa_lite_aspect']['show_text'] ){
return;
}
$content = do_the_fa_content($before, $after, $FA_slider_options['_fa_lite_aspect']['strip_shortcodes']);
if( $content )
echo $content;
}
/**
* Returns or echoes the slide content. Can do shortcodes if option is set
* @param string $before
* @param string $after
* @param bool $strip_shortcodes
* @param bool $echo
*/
function do_the_fa_content( $before = '', $after = '', $strip_shortcodes = true ){
// use the global $post since it's set by our loop and the original post gets restored after slider is displayed
global $post;
if( !$post ) return;
$content_html = '';
if( !$strip_shortcodes ){
$content_html .= do_shortcode($post->FA_post_content);
}else{
$content_html .= strip_shortcodes($post->FA_post_content);
}
$result = $before.$content_html.$after;
return $result;
}
/**
* Outputs the read-more link
*/
function the_fa_read_more( $class = 'FA_read_more' ){
// use the global $post since it's set by our loop and the original post gets restored after slider is displayed
global $post, $FA_slider_options;
if( !$post || !$FA_slider_options['_fa_lite_aspect']['show_read_more'] ) return;
$link_html = '%5$s';
// if no text is set for read-more link, don't display it
if( '' == trim($post->fa_read_more) ){
return;
}
printf( $link_html,
$class, // %1$s
get_permalink($post->ID), // %2$s
$post->post_title, // %3$s
$post->link_target, // %4$s
$post->fa_read_more // %5$s
);
}
/**
* Outputs the post date
*
* @param string $before - html to put before text
* @param string $after - html to put after text
* @param bool $echo - echo (true) or return(false) the html
* @return string - formatted date
*/
function the_fa_date( $before = '', $after = '', $echo = true ){
global $post, $FA_slider_options;
if( !$post || !$FA_slider_options['_fa_lite_aspect']['show_date'] ) return;
$the_date = get_the_date(get_option('date_format'), $post);
if( $echo ){
echo $before.$the_date.$after;
}else{
return $before.$the_date.$after;
}
}
/**
* Displays the given HTML tag is any content ( title, text, read more or date ) is set
* in slideshow settings to be displayed. Used for both opening a tag and closing it.
*
* @param string $tag - tag to be displayed if any content is set to be displayed
* @return void
*/
function fa_content_wrapper( $tag ){
global $FA_slider_options;
$aspect = $FA_slider_options['_fa_lite_aspect'];
$theme_fields = array();
if( isset( $FA_slider_options['_fa_lite_theme_details']['theme_config']['Fields'] ) ){
$theme_fields = $FA_slider_options['_fa_lite_theme_details']['theme_config']['Fields'];
}
$is_content = array(
'show_title',
'show_text',
'show_read_more',
'show_date'
);
foreach ($is_content as $key){
$is_disabled = array_key_exists($key, $theme_fields) && $theme_fields[$key];
if( $aspect[$key] && !$is_disabled ){
echo $tag;
break;
}
}
}
/**
* Returns the image as background styling
* @param string $image
* @param string $position
* @param string $repeat
* @param bool $echo
*/
function the_fa_background($show_image = true, $position = 'top left', $repeat = 'no-repeat', $echo = true ){
global $post;
if( !$post ) return;
$declarations = array();
$bg_color = get_post_meta($post->ID, '_fa_bg_color', true);
if( !empty( $bg_color ) ){
$declarations[] = 'background-color:'.$bg_color;
}
if( $show_image && !empty($post->FA_image) ){
$declarations[] = 'background-image:url('.$post->FA_image[0].'); background-position:'.$position.'; background-repeat:'.$repeat;
}
if( $echo )
echo implode('; ', $declarations);
else
return implode('; ', $declarations);
}
/**
* Display the title above the slider. Tests if title should be displayed in options.
* @param string $before
* @param string $after
* @param bool $echo
*/
function the_slideshow_title($before = '