/**
* Create and display plugin help tab content.
*
* @since 1.0.0
*
* @uses ddw_gfpe_info_values() To get some strings of info values.
* @uses ddw_gfpe_plugin_get_data() To display various data of this plugin.
* @uses ddw_gfpe_widget_shortcodes() To detect our widget shortcodes support.
*/
function ddw_gfpe_widgets_help_content()
{
$gfpe_info = (array) ddw_gfpe_info_values();
/** Helper string */
$gfpe_filter_help = ' — ' . sprintf(__('Fully optional, could be deactivated %svia filter%s.', 'genesis-featured-page-extras'), '<a href="' . esc_url($gfpe_info['url_snippets']) . '" target="_blank" title="' . __('Code Snippets for Customization', 'genesis-featured-page-extras') . '">', '</a>');
$gfpe_space_helper = '<div style="height: 5px;"></div>';
/** Headline */
echo '<h3>' . __('Plugin', 'genesis-featured-page-extras') . ': ' . __('Genesis Featured Page Extras', 'genesis-featured-page-extras') . ' <small>v' . esc_attr(ddw_gfpe_plugin_get_data('Version')) . '</small></h3>';
/** Widget Info */
echo '<h4>' . __('Usage & Instructions', 'genesis-featured-page-extras') . ':</h4>';
echo '<p><blockquote><ul>' . '<li>' . __('Use side by side with original Featured Widget or other third-party plugins', 'genesis-featured-page-extras') . '</li>' . '<li>' . __('Optional image URL: use media uploader to add an image file, or use external image (in the latter case, be aware of copyright issues!)', 'genesis-featured-page-extras') . '</li>' . '<li>' . __('For image size all built-in sizes (of WordPress) and additional registered sizes are available.', 'genesis-featured-page-extras') . ' ' . sprintf(__('Please be careful in using the %s size which equals to the original size!', 'genesis-featured-page-extras'), '<code>full</code>') . '</li>' . '<li>' . __('For page content teaser, choose one of the four options: full page content (including more options like limited content), page excerpt, your own custom content or even no content at all', 'genesis-featured-page-extras') . '</li>' . '<li>' . __('Intro & Outro texts are fully optional – will go below title (but before widget content), plus at the end of widget (after widget content)', 'genesis-featured-page-extras') . '</li>' . '<ul></blockquote></p>';
/** Widget & Page Title link info */
echo '<h4>' . __('Widget & Page Title Link', 'genesis-featured-page-extras') . ':</h4>';
echo '<p><blockquote><ul>' . '<li>' . __('Widget title by default has no link to it, you can use the permalink of your selected page or your own URL, including the link target', 'genesis-featured-page-extras') . '</li>' . '<li>' . __('Page title by default is linked to its permalink (of selected page)', 'genesis-featured-page-extras') . '</li>' . '<li>' . __('Both titles can also be hidden if desired', 'genesis-featured-page-extras') . '</li>' . '<ul></blockquote></p></p>';
/** More link info */
echo '<h4>' . sprintf(__('%s Link', 'genesis-featured-page-extras'), '<em>' . __('More', 'genesis-featured-page-extras') . '</em>') . ':</h4>';
echo '<p><blockquote><ul>' . '<li>' . __('More link defaults to the used page\'s permalink – or use your own URL, with optional link target setting', 'genesis-featured-page-extras') . '</li>' . '<li>' . __('Note: link target setting is not available for the default page permalink as it cannot be tweaked in this kind of widget environment (not targetable)', 'genesis-featured-page-extras') . '</li>' . '<ul></blockquote></p>';
/** Character limits info */
echo '<h4>' . __('Character Limits', 'genesis-featured-page-extras') . ':</h4>';
echo '<p><blockquote><ul>' . '<li>' . __('Note: Character limits for Page Title and Content Teaser', 'genesis-featured-page-extras') . ': ' . __('only integer values are allowed', 'genesis-featured-page-extras') . ', ' . __('plus: cutoff is always after the full word not within it!', 'genesis-featured-page-extras') . '</li>' . '<ul></blockquote></p>';
/** Styling info */
echo '<h4>' . __('Widget Styling', 'genesis-featured-page-extras') . ':</h4>';
echo '<p><blockquote><ul>' . '<li><em>' . sprintf(__('Styling - %s', 'genesis-featured-page-extras'), __('default', 'genesis-featured-page-extras')) . ':</em> ' . __('By default this widget leverages the original classes of Genesis Featured Widget, so all should work from the start', 'genesis-featured-page-extras') . '</li>' . '<li><em>' . sprintf(__('Styling - %s', 'genesis-featured-page-extras'), __('custom', 'genesis-featured-page-extras')) . ':</em> ' . __('As the widget also brings a few classes on its own you can tweak and/ or enhance styling if ever needed', 'genesis-featured-page-extras') . '</li>' . '<ul></blockquote></p>';
/** Widgets shortcode support */
if (ddw_gfpe_widget_shortcodes()) {
echo $gfpe_space_helper . '<p>' . sprintf(__('Currently, shortcodes are supported in all %s plus our %s of this plugin\'s widget.', 'genesis-featured-page-extras') . $gfpe_filter_help, '<em>' . __('Text Widgets', 'genesis-featured-page-extras') . '</em>', '<em>' . __('Custom Content Field', 'genesis-featured-page-extras') . '</em>') . '</p>';
}
// end if constant check
/** Set first release year */
$release_first_year = '' != $gfpe_info['first_release'] && date('Y') != $gfpe_info['first_release'] ? $gfpe_info['first_release'] . '–' : '';
/** Help footer: plugin info */
echo $gfpe_space_helper . '<p><h4>' . __('Important plugin links:', 'genesis-featured-page-extras') . '</h4>' . '<a class="button" href="' . esc_url($gfpe_info['url_plugin']) . '" target="_new" title="' . __('Plugin website', 'genesis-featured-page-extras') . '">' . __('Plugin website', 'genesis-featured-page-extras') . '</a>' . ' <a class="button" href="' . esc_url($gfpe_info['url_wporg_faq']) . '" target="_new" title="' . __('FAQ', 'genesis-featured-page-extras') . '">' . __('FAQ', 'genesis-featured-page-extras') . '</a>' . ' <a class="button" href="' . esc_url($gfpe_info['url_wporg_forum']) . '" target="_new" title="' . __('Support', 'genesis-featured-page-extras') . '">' . __('Support', 'genesis-featured-page-extras') . '</a>' . ' <a class="button" href="' . esc_url($gfpe_info['url_snippets']) . '" target="_new" title="' . __('Code Snippets for Customization', 'genesis-featured-page-extras') . '">' . __('Code Snippets', 'genesis-featured-page-extras') . '</a>' . ' <a class="button" href="' . esc_url($gfpe_info['url_translate']) . '" target="_new" title="' . __('Translations', 'genesis-featured-page-extras') . '">' . __('Translations', 'genesis-featured-page-extras') . '</a>' . ' <a class="button" href="' . esc_url($gfpe_info['url_donate']) . '" target="_new" title="' . __('Donate', 'genesis-featured-page-extras') . '"><strong>' . __('Donate', 'genesis-featured-page-extras') . '</strong></a></p>';
echo '<p><a href="' . esc_url($gfpe_info['url_license']) . '" target="_new" title="' . esc_attr($gfpe_info['license']) . '">' . esc_attr($gfpe_info['license']) . '</a> © ' . $release_first_year . date('Y') . ' <a href="' . esc_url(ddw_gfpe_plugin_get_data('AuthorURI')) . '" target="_new" title="' . esc_attr__(ddw_gfpe_plugin_get_data('Author')) . '">' . esc_attr__(ddw_gfpe_plugin_get_data('Author')) . '</a></p>';
}
/**
* Register our Widget class, include plugin file.
*
* @since 1.0.0
*
* @uses register_widget()
*/
function ddw_gfpe_register_widget()
{
/** Load widget code part */
require_once GFPE_PLUGIN_DIR . 'includes/gfpe-widget-featured-page-extras.php';
/** Register the widget - only if Genesis active */
if (defined('PARENT_THEME_VERSION')) {
return register_widget('DDW_Genesis_Featured_Page_Extras');
}
// end if
/** Add shortcode support to widgets */
if (ddw_gfpe_widget_shortcodes() && !is_admin()) {
add_filter('widget_text', 'do_shortcode');
}
// end if
}
