first commit

modules/ps_socialfollow/config.xml

@@ -0,0 +1,12 @@
+<?xml version="1.0" encoding="UTF-8" ?>
+<module>
+    <name>ps_socialfollow</name>
+    <displayName><![CDATA[Social media follow links]]></displayName>
+    <version><![CDATA[2.2.0]]></version>
+    <description><![CDATA[Allows you to add information about your brand&#039;s social networking accounts.]]></description>
+    <author><![CDATA[PrestaShop]]></author>
+    <tab><![CDATA[]]></tab>
+    <is_configurable>1</is_configurable>
+    <need_instance>1</need_instance>
+	<limited_countries></limited_countries>
+</module>

modules/ps_socialfollow/config_pl.xml

@@ -0,0 +1,12 @@
+<?xml version="1.0" encoding="UTF-8" ?>
+<module>
+    <name>ps_socialfollow</name>
+    <displayName><![CDATA[Odnośniki do medi&oacute;w społecznościowych]]></displayName>
+    <version><![CDATA[2.2.0]]></version>
+    <description><![CDATA[Facebook, Twitter, let your customers know where to follow you and increase your community.]]></description>
+    <author><![CDATA[PrestaShop]]></author>
+    <tab><![CDATA[]]></tab>
+    <is_configurable>1</is_configurable>
+    <need_instance>1</need_instance>
+	<limited_countries></limited_countries>
+</module>

modules/ps_socialfollow/index.php

@@ -0,0 +1,29 @@
+<?php
+/**
+ * Copyright since 2007 PrestaShop SA and Contributors
+ * PrestaShop is an International Registered Trademark & Property of PrestaShop SA
+ *
+ * NOTICE OF LICENSE
+ *
+ * This source file is subject to the Academic Free License 3.0 (AFL-3.0)
+ * that is bundled with this package in the file LICENSE.md.
+ * It is also available through the world-wide-web at this URL:
+ * https://opensource.org/licenses/AFL-3.0
+ * If you did not receive a copy of the license and are unable to
+ * obtain it through the world-wide-web, please send an email
+ * to license@prestashop.com so we can send you a copy immediately.
+ *
+ * @author    PrestaShop SA <contact@prestashop.com>
+ * @copyright Since 2007 PrestaShop SA and Contributors
+ * @license   https://opensource.org/licenses/AFL-3.0 Academic Free License 3.0 (AFL-3.0)
+ */
+
+header('Expires: Mon, 26 Jul 1997 05:00:00 GMT');
+header('Last-Modified: '.gmdate('D, d M Y H:i:s').' GMT');
+
+header('Cache-Control: no-store, no-cache, must-revalidate');
+header('Cache-Control: post-check=0, pre-check=0', false);
+header('Pragma: no-cache');
+
+header('Location: ../../');
+exit;

modules/ps_socialfollow/ps_socialfollow.php

@@ -0,0 +1,363 @@
+<?php
+/**
+ * Copyright since 2007 PrestaShop SA and Contributors
+ * PrestaShop is an International Registered Trademark & Property of PrestaShop SA
+ *
+ * NOTICE OF LICENSE
+ *
+ * This source file is subject to the Academic Free License 3.0 (AFL-3.0)
+ * that is bundled with this package in the file LICENSE.md.
+ * It is also available through the world-wide-web at this URL:
+ * https://opensource.org/licenses/AFL-3.0
+ * If you did not receive a copy of the license and are unable to
+ * obtain it through the world-wide-web, please send an email
+ * to license@prestashop.com so we can send you a copy immediately.
+ *
+ * @author    PrestaShop SA <contact@prestashop.com>
+ * @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('<br />', $result));
+            }
+        }
+
+        if (Shop::isFeatureActive() && Shop::getContext() != Shop::CONTEXT_SHOP) {
+            $html .=  '<p class="alert alert-warning">' .
+                $this->trans('Please choose a shop to edit the social media links.', array(), 'Modules.Socialfollow.Admin') .
+                '</p>';
+        } 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;
+    }
+}

modules/ps_socialfollow/ps_socialfollow.tpl

@@ -0,0 +1,29 @@
+{**
+ * Copyright since 2007 PrestaShop SA and Contributors
+ * PrestaShop is an International Registered Trademark & Property of PrestaShop SA
+ *
+ * NOTICE OF LICENSE
+ *
+ * This source file is subject to the Academic Free License 3.0 (AFL-3.0)
+ * that is bundled with this package in the file LICENSE.md.
+ * It is also available through the world-wide-web at this URL:
+ * https://opensource.org/licenses/AFL-3.0
+ * If you did not receive a copy of the license and are unable to
+ * obtain it through the world-wide-web, please send an email
+ * to license@prestashop.com so we can send you a copy immediately.
+ *
+ * @author    PrestaShop SA <contact@prestashop.com>
+ * @copyright Since 2007 PrestaShop SA and Contributors
+ * @license   https://opensource.org/licenses/AFL-3.0 Academic Free License 3.0 (AFL-3.0)
+ *}
+
+{block name='ps_social_follow'}
+  <div class="ps-social-follow">
+    <h4>{l s='Follow us' d='Modules.Socialfollow.Shop'}</h4>
+    <ul>
+      {foreach from=$social_links item='social_link'}
+        <li class="{$social_link.class}"><a href="{$social_link.url}">{$social_link.label}</a></li>
+      {/foreach}
+    </ul>
+  </div>
+{/block}

modules/ps_socialfollow/translations/index.php

@@ -0,0 +1,29 @@
+<?php
+/**
+ * Copyright since 2007 PrestaShop SA and Contributors
+ * PrestaShop is an International Registered Trademark & Property of PrestaShop SA
+ *
+ * NOTICE OF LICENSE
+ *
+ * This source file is subject to the Academic Free License 3.0 (AFL-3.0)
+ * that is bundled with this package in the file LICENSE.md.
+ * It is also available through the world-wide-web at this URL:
+ * https://opensource.org/licenses/AFL-3.0
+ * If you did not receive a copy of the license and are unable to
+ * obtain it through the world-wide-web, please send an email
+ * to license@prestashop.com so we can send you a copy immediately.
+ *
+ * @author    PrestaShop SA <contact@prestashop.com>
+ * @copyright Since 2007 PrestaShop SA and Contributors
+ * @license   https://opensource.org/licenses/AFL-3.0 Academic Free License 3.0 (AFL-3.0)
+ */
+				    	
+header("Expires: Mon, 26 Jul 1997 05:00:00 GMT");
+header("Last-Modified: ".gmdate("D, d M Y H:i:s")." GMT");
+						
+header("Cache-Control: no-store, no-cache, must-revalidate");
+header("Cache-Control: post-check=0, pre-check=0", false);
+header("Pragma: no-cache");
+						
+header("Location: ../");
+exit;