GetURL(); $layout = $params['layout'] ?? 'icon_link'; // 'box_count', 'button_count', 'button', 'icon_link' $lazy = isset($params['lazy']) ? ($params['lazy'] === 'true' || $params['lazy'] === true) : false; $mobile_iframe = isset($params['mobile_iframe']) ? ($params['mobile_iframe'] === 'true' || $params['mobile_iframe'] === true) : false; $size = $params['size'] ?? 'small'; // 'large', 'small' $locale = $params['locale'] ?? \CmsNlsOperations::get_current_language(); $appId = isset($params['appId']) ? trim($params['appId']) : null; $id = trim($params['id'] ?? ''); $class = trim($params['class'] ?? ''); $div_attrs = ''; if ($id !== '') { $div_attrs .= ' id="' . htmlspecialchars($id, ENT_QUOTES) . '"'; } $div_class = trim("fb-share-button $class"); $div_attrs .= ' class="' . htmlspecialchars($div_class, ENT_QUOTES) . '"'; // Add data attributes $div_attrs .= ' data-href="' . htmlspecialchars($href, ENT_QUOTES) . '"'; $div_attrs .= ' data-layout="' . htmlspecialchars($layout, ENT_QUOTES) . '"'; $div_attrs .= ' data-size="' . htmlspecialchars($size, ENT_QUOTES) . '"'; if ($lazy) { $div_attrs .= ' data-lazy="true"'; } if ($mobile_iframe) { $div_attrs .= ' data-mobile_iframe="true"'; } $sdk_url = "https://connect.facebook.net/{$locale}/sdk.js#xfbml=1&version=v24.0"; if ($appId) { $sdk_url .= "&appId=" . rawurlencode($appId); } $html = <<

EOT; return $html; } function smarty_cms_help_function_FacebookShareDialog() { ?>

What does this do?

Facebook offers an easy-to-use Share dialog that you can include on your web page or in your mobile web app so people can share links on their timeline, in groups, or to their friends via a Facebook Message.

How do I use it?

Insert the tag {FacebookShareDialog} into your template or page (case sensitive).

To ensure that web-designers have maximum control over customization, if you want to style the plugin's output, feel free to use additional external CSS rules in conjunction with the class parameter.

Alternatively, you can always use the custom_url parameters to set manually (or pass them via smarty) the url and title values of the current page without self detection functionality.

What parameters does it take?

(optional) href or url
- The absolute URL of the page that will be shared. Defaults to current page URL.
- E.g. {FacebookShareDialog href="https://example.com/page"}
(optional) layout
- Selects the layout for the plugin. Can be: box_count, button_count, button, icon_link
- Default: icon_link
- E.g. {FacebookShareDialog layout="button_count"}
(optional) lazy
- Use browser's lazy-loading mechanism. Can be true or false
- Default: false
- E.g. {FacebookShareDialog lazy="true"}
(optional) mobile_iframe (Deprecated)
- Open share dialog in iframe on mobile instead of popup. Can be true or false
- Default: false
- E.g. {FacebookShareDialog mobile_iframe="true"}
(optional) size
- Button size. Can be large or small
- Default: small
- E.g. {FacebookShareDialog size="large"}
(optional) locale
- Language locale for the button. Defaults to current site language.
- E.g. {FacebookShareDialog locale="en_US"}
(optional) appId
- Your Facebook App ID for analytics and insights.
- E.g. {FacebookShareDialog appId="123456789"}
(optional) class
- CSS class name for styling the button container
- E.g. {FacebookShareDialog class="my-share-button"}
(optional) id
- HTML ID attribute for the button container
- E.g. {FacebookShareDialog id="share-btn-1"}

Author: Magal Hezi

Update: Check for updates for this plugin at the CMS Made Simple Forge page

Feature Requests: If you want to add others social bookmarking services or functionality, please let me know by opening a new feature request in the dedicated Feature Requests tab of the CMS Made Simple Forge page for this plugin

Bugs: If you want to submit a new bug, please let me know by opening a new bug in the dedicated Bug Tracker tab of the CMS Made Simple Forge page for this plugin

Licence: Free software under the GNU General Public License

Change History:

Version 2.0

Updated to Facebook SDK v24.0
Added support for all Facebook Share Button attributes: href, layout, lazy, mobile_iframe, size
Changed default layout from 'button' to 'icon_link'
Improved parameter validation and HTML escaping
Updated documentation with complete parameter reference

Version 1.0

First release