* @copyright Since 2007 PrestaShop SA and Contributors
* @license https://opensource.org/licenses/AFL-3.0 Academic Free License 3.0 (AFL-3.0)
*/
if (!defined('_CAN_LOAD_FILES_')) {
exit;
}
use PrestaShop\PrestaShop\Core\Module\WidgetInterface;
use Symfony\Component\Validator\Constraints\Url;
use Symfony\Component\Validator\Validation;
class Ps_Socialfollow extends Module implements WidgetInterface
{
const SOCIAL_NETWORKS = [
'FACEBOOK',
'TWITTER',
'RSS',
'YOUTUBE',
'PINTEREST',
'VIMEO',
'INSTAGRAM',
'LINKEDIN',
];
private $templateFile;
public function __construct()
{
$this->name = 'ps_socialfollow';
$this->author = 'PrestaShop';
$this->version = '2.2.0';
$this->bootstrap = true;
parent::__construct();
$this->displayName = $this->trans('Social media follow links', array(), 'Modules.Socialfollow.Admin');
$this->description = $this->trans('Facebook, Twitter, let your customers know where to follow you and increase your community.', array(), 'Modules.Socialfollow.Admin');
$this->ps_versions_compliancy = array('min' => '1.7.4.0', 'max' => _PS_VERSION_);
$this->templateFile = 'module:ps_socialfollow/ps_socialfollow.tpl';
}
public function install()
{
return (parent::install() &&
Configuration::updateValue('BLOCKSOCIAL_FACEBOOK', '') &&
Configuration::updateValue('BLOCKSOCIAL_TWITTER', '') &&
Configuration::updateValue('BLOCKSOCIAL_RSS', '') &&
Configuration::updateValue('BLOCKSOCIAL_YOUTUBE', '') &&
Configuration::updateValue('BLOCKSOCIAL_PINTEREST', '') &&
Configuration::updateValue('BLOCKSOCIAL_VIMEO', '') &&
Configuration::updateValue('BLOCKSOCIAL_INSTAGRAM', '') &&
Configuration::updateValue('BLOCKSOCIAL_LINKEDIN', '') &&
$this->registerHook('displayFooter'));
}
public function uninstall()
{
return (Configuration::deleteByName('BLOCKSOCIAL_FACEBOOK') &&
Configuration::deleteByName('BLOCKSOCIAL_TWITTER') &&
Configuration::deleteByName('BLOCKSOCIAL_RSS') &&
Configuration::deleteByName('BLOCKSOCIAL_YOUTUBE') &&
Configuration::deleteByName('BLOCKSOCIAL_PINTEREST') &&
Configuration::deleteByName('BLOCKSOCIAL_VIMEO') &&
Configuration::deleteByName('BLOCKSOCIAL_INSTAGRAM') &&
Configuration::deleteByName('BLOCKSOCIAL_LINKEDIN') &&
parent::uninstall());
}
public function getContent()
{
$html = '';
if (Tools::isSubmit('submitModule')) {
$result = $this->updateFields();
if ($result === true) {
$this->_clearCache('*');
Tools::redirectAdmin($this->context->link->getAdminLink('AdminModules', true, [], [
'configure' => $this->name,
'conf' => 4,
]));
} else {
$html .= $this->displayError(implode('
', $result));
}
}
if (Shop::isFeatureActive() && Shop::getContext() != Shop::CONTEXT_SHOP) {
$html .= '
' . $this->trans('Please choose a shop to edit the social media links.', array(), 'Modules.Socialfollow.Admin') . '
'; } else { $html .= $this->renderForm(); } return $html; } public function _clearCache($template, $cache_id = null, $compile_id = null) { parent::_clearCache($this->templateFile); } public function renderForm() { $fields_form = array( 'form' => array( 'legend' => array( 'title' => $this->trans('Settings', array(), 'Admin.Global'), 'icon' => 'icon-cogs' ), 'input' => array( array( 'type' => 'text', 'lang' => true, 'label' => $this->trans('Facebook URL', array(), 'Modules.Socialfollow.Admin'), 'name' => 'BLOCKSOCIAL_FACEBOOK', 'desc' => $this->trans('Your Facebook fan page.', array(), 'Modules.Socialfollow.Admin'), ), array( 'type' => 'text', 'lang' => true, 'label' => $this->trans('Twitter URL', array(), 'Modules.Socialfollow.Admin'), 'name' => 'BLOCKSOCIAL_TWITTER', 'desc' => $this->trans('Your official Twitter account.', array(), 'Modules.Socialfollow.Admin'), ), array( 'type' => 'text', 'lang' => true, 'label' => $this->trans('RSS URL', array(), 'Modules.Socialfollow.Admin'), 'name' => 'BLOCKSOCIAL_RSS', 'desc' => $this->trans('The RSS feed of your choice (your blog, your store, etc.).', array(), 'Modules.Socialfollow.Admin'), ), array( 'type' => 'text', 'lang' => true, 'label' => $this->trans('YouTube URL', array(), 'Modules.Socialfollow.Admin'), 'name' => 'BLOCKSOCIAL_YOUTUBE', 'desc' => $this->trans('Your official YouTube account.', array(), 'Modules.Socialfollow.Admin'), ), array( 'type' => 'text', 'lang' => true, 'label' => $this->trans('Pinterest URL:', array(), 'Modules.Socialfollow.Admin'), 'name' => 'BLOCKSOCIAL_PINTEREST', 'desc' => $this->trans('Your official Pinterest account.', array(), 'Modules.Socialfollow.Admin'), ), array( 'type' => 'text', 'lang' => true, 'label' => $this->trans('Vimeo URL:', array(), 'Modules.Socialfollow.Admin'), 'name' => 'BLOCKSOCIAL_VIMEO', 'desc' => $this->trans('Your official Vimeo account.', array(), 'Modules.Socialfollow.Admin'), ), array( 'type' => 'text', 'lang' => true, 'label' => $this->trans('Instagram URL:', array(), 'Modules.Socialfollow.Admin'), 'name' => 'BLOCKSOCIAL_INSTAGRAM', 'desc' => $this->trans('Your official Instagram account.', array(), 'Modules.Socialfollow.Admin'), ), array( 'type' => 'text', 'lang' => true, 'label' => $this->trans('LinkedIn URL:', array(), 'Modules.Socialfollow.Admin'), 'name' => 'BLOCKSOCIAL_LINKEDIN', 'desc' => $this->trans('Your official LinkedIn account.', array(), 'Modules.Socialfollow.Admin'), ), ), 'submit' => array( 'title' => $this->trans('Save', array(), 'Admin.Global'), ) ), ); $helper = new HelperForm(); $helper->show_toolbar = false; $helper->table = $this->table; $helper->submit_action = 'submitModule'; $helper->currentIndex = $this->context->link->getAdminLink('AdminModules', true, [], ['configure' => $this->name]); $helper->tpl_vars = array( 'fields_value' => $this->getConfigFieldsValues(), ); $helper->languages = $this->context->controller->getLanguages(); $helper->default_form_language = (int)$this->context->language->id; return $helper->generateForm(array($fields_form)); } public function getConfigFieldsValues() { $result = []; foreach (static::SOCIAL_NETWORKS as $social) { $configuration_name = "BLOCKSOCIAL_$social"; if (!empty(Configuration::get($configuration_name))) { $this->upgradeConfiguration($configuration_name); } foreach (Language::getIDs() as $id_lang) { $conf = Configuration::get($configuration_name, $id_lang); $result[$configuration_name][$id_lang] = $conf; } } return $result; } /** * This upgrades the configuration of the module from simple values to localized values. This assures that the * upgrade of the module keeps the old configurations, and that the change is transparent to the user. * * This function is only run once during upgrade, i.e. the first time the user accesses the configuration in the BO * after an upgrade of the module to the localized version. * * @param $name string Name of the configuration setting * @return array Configuration value, now localized */ protected function upgradeConfiguration($name) { $value = Configuration::get($name); if (!empty($value) && !is_array($value)) { $value_localized = []; foreach (Language::getIDs() as $id_lang) { $value_localized[$id_lang] = $value; } Configuration::updateValue($name, $value_localized); $value = $value_localized; } return $value; } public function renderWidget($hookName = null, array $configuration = []) { if (!$this->isCached($this->templateFile, $this->getCacheId('ps_socialfollow'))) { $this->smarty->assign($this->getWidgetVariables($hookName, $configuration)); } return $this->fetch($this->templateFile, $this->getCacheId('ps_socialfollow')); } public function getWidgetVariables($hookName = null, array $configuration = []) { $social_links = array(); $id_lang = (int)$this->context->language->id; if ($sf_facebook = Configuration::get('BLOCKSOCIAL_FACEBOOK', $id_lang)) { $social_links['facebook'] = array( 'label' => $this->trans('Facebook', array(), 'Modules.Socialfollow.Shop'), 'class' => 'facebook', 'url' => $sf_facebook, ); } if ($sf_twitter = Configuration::get('BLOCKSOCIAL_TWITTER', $id_lang)) { $social_links['twitter'] = array( 'label' => $this->trans('Twitter', array(), 'Modules.Socialfollow.Shop'), 'class' => 'twitter', 'url' => $sf_twitter, ); } if ($sf_rss = Configuration::get('BLOCKSOCIAL_RSS', $id_lang)) { $social_links['rss'] = array( 'label' => $this->trans('Rss', array(), 'Modules.Socialfollow.Shop'), 'class' => 'rss', 'url' => $sf_rss, ); } if ($sf_youtube = Configuration::get('BLOCKSOCIAL_YOUTUBE', $id_lang)) { $social_links['youtube'] = array( 'label' => $this->trans('YouTube', array(), 'Modules.Socialfollow.Shop'), 'class' => 'youtube', 'url' => $sf_youtube, ); } if ($sf_pinterest = Configuration::get('BLOCKSOCIAL_PINTEREST', $id_lang)) { $social_links['pinterest'] = array( 'label' => $this->trans('Pinterest', array(), 'Modules.Socialfollow.Shop'), 'class' => 'pinterest', 'url' => $sf_pinterest, ); } if ($sf_vimeo = Configuration::get('BLOCKSOCIAL_VIMEO', $id_lang)) { $social_links['vimeo'] = array( 'label' => $this->trans('Vimeo', array(), 'Modules.Socialfollow.Shop'), 'class' => 'vimeo', 'url' => $sf_vimeo, ); } if ($sf_instagram = Configuration::get('BLOCKSOCIAL_INSTAGRAM', $id_lang)) { $social_links['instagram'] = array( 'label' => $this->trans('Instagram', array(), 'Modules.Socialfollow.Shop'), 'class' => 'instagram', 'url' => $sf_instagram, ); } if ($sf_linkedin = Configuration::get('BLOCKSOCIAL_LINKEDIN', $id_lang)) { $social_links['linkedin'] = array( 'label' => $this->trans('LinkedIn', array(), 'Modules.Socialfollow.Shop'), 'class' => 'linkedin', 'url' => $sf_linkedin, ); } return array( 'social_links' => $social_links, ); } /** * Update form fields. * Check all social networks form value and verify the URL is valid. * Do nothing if a violation is spotted. * * @return array|bool true on success, errors on failure */ protected function updateFields() { $validator = Validation::createValidator(); $constraints = [new Url()]; $values = []; $errors = []; foreach (static::SOCIAL_NETWORKS as $social) { foreach (Language::getIDs() as $id_lang) { $values[$social][$id_lang] = trim(Tools::getValue("BLOCKSOCIAL_{$social}_{$id_lang}", '')); $violations = $validator->validate($values[$social][$id_lang], $constraints); if (count($violations)) { $errors[] = $this->trans('Invalid URL', [], 'Admin.Notifications.Error') . ': ' . $values[$social][$id_lang]; } } } if (empty($errors)) { foreach (static::SOCIAL_NETWORKS as $social) { Configuration::updateValue("BLOCKSOCIAL_$social", $values[$social]); } return true; } return $errors; } }