/**
* @file
* An AddThis-class.
- *
- * @author Jani Palsamäki
*/
class AddThis {
// AddThis attribute and parameter names (as defined in AddThis APIs)
const PROFILE_ID_QUERY_PARAMETER = 'pubid';
const TITLE_ATTRIBUTE = 'addthis:title';
+ const URL_ATTRIBUTE = 'addthis:url';
// Persistent variable keys
const ADDRESSBOOK_ENABLED_KEY = 'addthis_addressbook_enabled';
const CUSTOM_CONFIGURATION_CODE_ENABLED_KEY = 'addthis_custom_configuration_code_enabled';
const CUSTOM_CONFIGURATION_CODE_KEY = 'addthis_custom_configuration_code';
const ENABLED_SERVICES_KEY = 'addthis_enabled_services';
- const LARGE_ICONS_ENABLED_KEY = 'addthis_large_icons_enabled';
- const NUMBER_OF_PREFERRED_SERVICES_KEY = 'addthis_number_of_preferred_services';
const OPEN_WINDOWS_ENABLED_KEY = 'addthis_open_windows_enabled';
const PROFILE_ID_KEY = 'addthis_profile_id';
const SERVICES_CSS_URL_KEY = 'addthis_services_css_url';
const UI_HEADER_BACKGROUND_COLOR_KEY = 'addthis_ui_header_background_color';
const UI_HEADER_COLOR_KEY = 'addthis_ui_header_color';
const WIDGET_JS_URL_KEY = 'addthis_widget_js_url';
+ const WIDGET_JS_ASYNC = 'addthis_widget_async';
// External resources
const DEFAULT_BOOKMARK_URL = 'http://www.addthis.com/bookmark.php?v=250';
const DEFAULT_SERVICES_CSS_URL = 'http://cache.addthiscdn.com/icons/v1/sprites/services.css';
const DEFAULT_SERVICES_JSON_URL = 'http://cache.addthiscdn.com/services/v1/sharing.en.json';
const DEFAULT_WIDGET_JS_URL = 'http://s7.addthis.com/js/250/addthis_widget.js';
+ const DEFAULT_WIDGET_JS_ASYNC = TRUE;
// Internal resources
const ADMIN_CSS_FILE = 'addthis.admin.css';
const ADMIN_INCLUDE_FILE = 'includes/addthis.admin.inc';
// Widget types
- const WIDGET_TYPE_COMPACT_BUTTON = 'compact_button';
- const WIDGET_TYPE_DISABLED = 'disabled';
- const WIDGET_TYPE_LARGE_BUTTON = 'large_button';
- const WIDGET_TYPE_SHARECOUNT = 'sharecount';
- const WIDGET_TYPE_TOOLBOX = 'toolbox';
+ const WIDGET_TYPE_DISABLED = 'addthis_disabled';
- private static $instance;
+ // Styles
+ const CSS_32x32 = 'addthis_32x32_style';
- /* @var AddThisConfigurationGenerator */
- private $addThisConfigurationGenerator;
+ private static $instance;
- /* @var Json */
+ /* @var AddThisJson */
private $json;
- /* @var MarkupGenerator */
- private $markupGenerator;
-
/**
* @return AddThis
*/
public static function getInstance() {
if (!isset(self::$instance)) {
$addThis = new AddThis();
- $addThis->setAddThisConfigurationGenerator(new AddThisConfigurationGenerator());
- $addThis->setJson(new Json());
- $addThis->setMarkupGenerator(new MarkupGenerator());
+ $addThis->setJson(new AddThisJson());
self::$instance = $addThis;
}
return self::$instance;
}
- public function setAddThisConfigurationGenerator(AddThisConfigurationGenerator $addThisConfigurationGenerator) {
- $this->addThisConfigurationGenerator = $addThisConfigurationGenerator;
- }
-
- public function setJson(Json $json) {
+ public function setJson(AddThisJson $json) {
$this->json = $json;
}
- public function setMarkupGenerator(MarkupGenerator $markupGenerator) {
- $this->markupGenerator = $markupGenerator;
- }
-
- public function getWidgetTypes() {
+ /*
+ * Get all the DisplayTypes that are available.
+ */
+ public function getDisplayTypes() {
return array(
self::WIDGET_TYPE_DISABLED => t('Disabled'),
- self::WIDGET_TYPE_COMPACT_BUTTON => t('Compact button'),
- self::WIDGET_TYPE_LARGE_BUTTON => t('Large button'),
- self::WIDGET_TYPE_TOOLBOX => t('Toolbox'),
- self::WIDGET_TYPE_SHARECOUNT => t('Sharecount'),
);
+ // @todo Get all display types available and
+ // provide a array with their names.
}
- public function getBlockWidgetType() {
- return variable_get(self::BLOCK_WIDGET_TYPE_KEY, self::WIDGET_TYPE_COMPACT_BUTTON);
- }
+ /*
+ * Return me the markup for a certain display type.
+ *
+ * Variables contains #entity and #settings as keys when applicable.
+ * When #entity is not there we link to the current url. When #settings
+ * is not there we use the default settings.
+ */
+ public function getDisplayMarkup($display, $options = array()) {
+ $formatters = addthis_field_info_formatter_field_type();
+
+ // When we have the entity and entity_type we can send it to the url.
+ if (isset($options['#entity']) && isset($options['#entity_type'])) {
+ // See if we can create the url and send it through a hook so others
+ // can play with it.
+ $uri = entity_uri($options['#entity_type'], $options['#entity']);
+ $uri['options'] += array(
+ 'absolute' => TRUE,
+ );
+ // Add hook here to alter the uri maybe also based on fields from the
+ // entity. Like a custom share link. Pass $options and $uri. Return
+ // a uri object to which we can reset it. Maybe use the alter structure.
+
+ $options['#url'] = url($uri['path'], $uri['options']);
+ }
+ // @todo Hash the options array and cache the markup.
+ // This will save all the extra calls to modules and alters.
+
+ // Give other module the option to alter our markup options.
+ drupal_alter('addthis_markup_options', $options);
+
+ $markup = array(
+ '#display' => $options['#display'],
+ );
+ if (array_key_exists($display, $formatters)) {
+ // The display type is found. Now get it and get the markup.
+ $display_inf = $formatters[$display];
+
+ // Get all hook implementation to verify later if we can call it.
+ $implementations = module_implements('addthis_display_markup');
+
+ // First we look for a targeted implementation to call.
+ if (function_exists($display_inf['module'] . '_addthis_display_markup__' . $display)) {
+ $markup += call_user_func_array($display_inf['module'] . '_addthis_display_markup__' . $display, array($options));
+
+ // This should be the default implementation that is called.
+ }
+ elseif (in_array($display_inf['module'], $implementations)) {
+ $markup += module_invoke($display_inf['module'], 'addthis_display_markup', $display, $options);
+ }
+ // Give other module the option to later our markup.
+ drupal_alter('addthis_markup', $markup);
+ return $markup;
- public function getWidgetMarkup($widgetType = '', $entity = NULL) {
- $markup = '';
- if (self::WIDGET_TYPE_LARGE_BUTTON == $widgetType) {
- $markup = $this->getLargeButtonWidgetMarkup($entity);
- } elseif (self::WIDGET_TYPE_COMPACT_BUTTON == $widgetType) {
- $markup = $this->getCompactButtonWidgetMarkup($entity);
- } elseif (self::WIDGET_TYPE_TOOLBOX == $widgetType) {
- $markup = $this->getToolboxWidgetMarkup($entity);
- } elseif (self::WIDGET_TYPE_SHARECOUNT == $widgetType) {
- $markup = $this->getSharecountWidgetMarkup($entity);
}
- return $markup;
+ else {
+ // Return empty
+ return array();
+ }
+ // If no display is found or something went wrong we go here.
+ return array();
+ }
+
+ /*
+ * Get the type DisplayType used for our AddThis block.
+ */
+ public function getBlockDisplayType() {
+ return variable_get(self::BLOCK_WIDGET_TYPE_KEY, self::WIDGET_TYPE_DISABLED);
}
public function getProfileId() {
$services = $this->json->decode($this->getServicesJsonUrl());
if (empty($services)) {
drupal_set_message(t('AddThis services could not be loaded from ' . $this->getServicesJsonUrl()), 'warning');
- } else {
- foreach ($services['data'] AS $service) {
+ }
+ else {
+ foreach ($services['data'] as $service) {
$serviceCode = check_plain($service['code']);
$serviceName = check_plain($service['name']);
$rows[$serviceCode] = '<span class="addthis_service_icon icon_' . $serviceCode . '"></span> ' . $serviceName;
return variable_get(self::ENABLED_SERVICES_KEY, array());
}
+ public function getWidgetJsAsync() {
+ return variable_get(self::WIDGET_JS_ASYNC, self::DEFAULT_WIDGET_JS_ASYNC);
+ }
+
public function addStylesheets() {
drupal_add_css($this->getServicesCssUrl(), 'external');
drupal_add_css($this->getAdminCssFilePath(), 'file');
}
public function addWidgetJs() {
- drupal_add_js(self::getWidgetUrl(), array('type' => 'external', 'scope' => 'footer'));
+ // Define if we load async or not.
+ $url = self::getWidgetUrl() . (self::getWidgetJsAsync() ? '?async=1' : '');
+ if (self::getWidgetJsAsync()) {
+ drupal_add_js(
+ array(
+ 'addthis' => array(
+ 'widget_url' => $url,
+ ),
+ ),
+ 'setting'
+ );
+ }
+ else {
+ // Add AddThis.com resources
+ drupal_add_js(
+ $url,
+ array(
+ 'type' => 'external',
+ 'group' => JS_LIBRARY,
+ 'every_page' => TRUE,
+ 'weight' => 9,
+ )
+ );
+ }
+ // Add local internal behaviours
+ if (self::getWidgetJsAsync()) {
+ drupal_add_js(
+ drupal_get_path('module', 'addthis') . '/addthis.js',
+ array(
+ 'group' => JS_DEFAULT,
+ 'weight' => 10,
+ 'every_page' => TRUE,
+ 'preprocess' => TRUE,
+ )
+ );
+ }
}
public function addConfigurationOptionsJs() {
if ($this->isCustomConfigurationCodeEnabled()) {
$javascript = $this->getCustomConfigurationCode();
- } else {
- $enabledServices = $this->getServiceNamesAsCommaSeparatedString() . 'more';
- $javascript = 'var addthis_config = {'
- . $this->addThisConfigurationGenerator->generate('services_compact', $enabledServices)
- . $this->addThisConfigurationGenerator->generate('data_track_clickback', $this->isClickbackTrackingEnabled())
- . $this->addThisConfigurationGenerator->generate('ui_508_compliant', $this->get508Compliant())
- . $this->addThisConfigurationGenerator->generate('ui_click', $this->isClickToOpenCompactMenuEnabled())
- . $this->addThisConfigurationGenerator->generate('ui_cobrand', $this->getCoBrand())
- . $this->addThisConfigurationGenerator->generate('ui_delay', $this->getUiDelay())
- . $this->addThisConfigurationGenerator->generate('ui_header_background', $this->getUiHeaderBackgroundColor())
- . $this->addThisConfigurationGenerator->generate('ui_header_color', $this->getUiHeaderColor())
- . $this->addThisConfigurationGenerator->generate('ui_open_windows', $this->isOpenWindowsEnabled())
- . $this->addThisConfigurationGenerator->generate('ui_use_css', $this->isStandardCssEnabled())
- . $this->addThisConfigurationGenerator->generateWithoutTrailingComma('ui_use_addressbook', $this->isAddressbookEnabled())
- . '}'
- ;
}
- drupal_add_js($javascript, array('type' => 'inline'));
- }
+ else {
+ $enabledServices = $this->getServiceNamesAsCommaSeparatedString() . 'more';
- public function areLargeIconsEnabled() {
- return (boolean) variable_get(self::LARGE_ICONS_ENABLED_KEY, TRUE);
+ global $language;
+ $configuration = array(
+ 'services_compact' => $enabledServices,
+ 'data_track_clickback' => $this->isClickbackTrackingEnabled(),
+ 'ui_508_compliant' => $this->get508Compliant(),
+ 'ui_click' => $this->isClickToOpenCompactMenuEnabled(),
+ 'ui_cobrand' => $this->getCoBrand(),
+ 'ui_delay' => $this->getUiDelay(),
+ 'ui_header_background' => $this->getUiHeaderBackgroundColor(),
+ 'ui_header_color' => $this->getUiHeaderColor(),
+ 'ui_open_windows' => $this->isOpenWindowsEnabled(),
+ 'ui_use_css' => $this->isStandardCssEnabled(),
+ 'ui_use_addressbook' => $this->isAddressbookEnabled(),
+ 'ui_language' => $language->language,
+ );
+ drupal_alter('addthis_configuration', $configuration);
+
+ $javascript = 'var addthis_config = ' . drupal_json_encode($configuration);
+ }
+ drupal_add_js(
+ $javascript,
+ array(
+ 'type' => 'inline',
+ 'scope' => 'footer',
+ 'every_page' => TRUE,
+ )
+ );
}
public function isClickToOpenCompactMenuEnabled() {
return check_url(variable_get(self::BOOKMARK_URL_KEY, self::DEFAULT_BOOKMARK_URL));
}
- public function getNumberOfPreferredServices() {
- return variable_get(self::NUMBER_OF_PREFERRED_SERVICES_KEY, self::DEFAULT_NUMBER_OF_PREFERRED_SERVICES);
- }
-
public function getCoBrand() {
- return variable_get(self::CO_BRAND_KEY);
+ return variable_get(self::CO_BRAND_KEY, '');
}
public function get508Compliant() {
return (boolean) variable_get(self::ADDRESSBOOK_ENABLED_KEY, FALSE);
}
- private function getLargeButtonWidgetMarkup($entity) {
- return '<a class="addthis_button" '
- . $this->getAddThisAttributesMarkup($entity)
- . $this->markupGenerator->generateAttribute('href', self::getFullBookmarkUrl())
- . '><img src="http://s7.addthis.com/static/btn/v2/lg-share-en.gif" width="125" height="16" alt="'
- . t('Bookmark and Share')
- . '" style="border:0"/></a>';
- }
-
- private function getCompactButtonWidgetMarkup($entity) {
- return '<a class="addthis_button" '
- . self::getAddThisAttributesMarkup($entity)
- . $this->markupGenerator->generateAttribute('href', $this->getFullBookmarkUrl())
- . '><img src="http://s7.addthis.com/static/btn/sm-share-en.gif" width="83" height="16" alt="'
- . t('Bookmark and Share')
- . '" style="border:0"/></a>';
- }
-
- private function getToolboxWidgetMarkup($entity) {
- $markup = '<div class="addthis_toolbox addthis_default_style '
- . $this->getLargeButtonsClass()
- . '" '
- . $this->getAddThisAttributesMarkup($entity)
- . '><a '
- . $this->markupGenerator->generateAttribute('href', $this->getFullBookmarkUrl())
- . ' class="addthis_button_compact"></a>';
+ /**
+ * Define the following object in the $optoins.
+ *
+ * #entity_type
+ * #entity
+ * #url
+ */
+ public function getAddThisAttributesMarkup($options) {
+ if (isset($options)) {
+ $attributes = array();
- $numberOfPreferredServices = self::getNumberOfPreferredServices();
+ // Add title
+ if (isset($options['#entity'])) {
+ $attributes += $this->getAttributeTitle($options['#entity']);
+ }
+ $attributes += $this->getAttributeUrl($options);
- for ($i = 1; $i <= $numberOfPreferredServices; $i++) {
- $markup .= "<a class=\"addthis_button_preferred_$i\"></a>";
+ // Return the array with attributes
+ return $attributes;
}
-
- $markup .= '</div>';
-
- return $markup;
- }
-
- private function getSharecountWidgetMarkup($entity) {
- return '<div class="addthis_toolbox addthis_default_style"><a class="addthis_counter" '
- . $this->getAddThisAttributesMarkup($entity)
- . '></a></div>';
+ return array();
}
- private function getAddThisAttributesMarkup($entity) {
- if (is_object($entity)) {
- return $this->getAddThisTitleAttributeMarkup($entity) . ' ';
+ private function getAttributeTitle($entity) {
+ if (isset($entity->title)) {
+ return array(
+ self::TITLE_ATTRIBUTE => (check_plain($entity->title) . ' - ' . variable_get('site_name')),
+ );
}
- return '';
+ return array();
}
- private function getAddThisTitleAttributeMarkup($entity) {
- return $this->markupGenerator->generateAttribute(
- self::TITLE_ATTRIBUTE, drupal_get_title() . ' - ' . check_plain($entity->title)
- );
+ private function getAttributeUrl($options) {
+ if (isset($options['#url'])) {
+ return array(
+ self::URL_ATTRIBUTE => $options['#url'],
+ );
+ }
+ return array();
}
- private function getLargeButtonsClass() {
+ public function getLargeButtonsClass() {
return $this->areLargeIconsEnabled() ? ' addthis_32x32_style ' : '';
}
return drupal_get_path('module', self::MODULE_NAME) . '/' . self::ADMIN_CSS_FILE;
}
- private function getFullBookmarkUrl() {
- return check_url($this->getBaseBookmarkUrl() . $this->getProfileIdQueryParameterPrefixedWithAmp());
+ /*
+ * Helper function. Get a bookmark url appended with the ProfileId
+ */
+ public function getFullBookmarkUrl() {
+ return $this->getBaseBookmarkUrl() . $this->getProfileIdQueryParameterPrefixedWithAmp();
}
private function getProfileIdQueryParameter($prefix) {
projects / project/addthis.git / blobdiff