WIP: Add share twig extension

src/ShareTwigExtension.php

@@ -0,0 +1,171 @@
+<?php
+
+namespace Massive\Component\Web;
+
+/**
+ * Share twig extension.
+ */
+class ShareTwigExtension extends \Twig_Extension
+{
+ /**
+ * @var string
+ */
+ private $facebookAppId;
+
+ /**
+ * @var string
+ */
+ private $campaignSource;
+
+ /**
+ * @param string $facebookAppId
+ * @param string $campaignSource
+ */
+ public function __construct($campaignSource = 'website', $facebookAppId = '')
+ {
+ $this->campaignSource = $campaignSource;
+ $this->facebookAppId = $facebookAppId;
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function getFunctions()
+ {
+ return [
+ new \Twig_SimpleFunction('share_url', [$this, 'getCampaignUrl']),
+ new \Twig_SimpleFunction('share_email', [$this, 'getEmailUrl']),
+ new \Twig_SimpleFunction('share_pinterest', [$this, 'getPinterestUrl']),
+ new \Twig_SimpleFunction('share_facebook', [$this, 'getFacebookUrl']),
+ new \Twig_SimpleFunction('share_twitter', [$this, 'getTwitterUrl']),
+ new \Twig_SimpleFunction('share_whatsapp', [$this, 'getWhatsAppUrl']),
+ new \Twig_SimpleFunction('share_messenger', [$this, 'getMessengerAppUrl']),
+ ];
+ }
+
+ /**
+ * Get email url.
+ *
+ * @param string $shareUrl
+ * @param string $subject
+ * @param string $body
+ *
+ * @return string
+ */
+ public function getEmailUrl($shareUrl, $subject, $body)
+ {
+ $shareUrl = $this->getCampaignUrl($shareUrl, 'mail', 'button');
+
+ if (false === strpos($body, '%url%')) {
+ $body .= "\r\n\r\n%url%";
+ }
+
+ $body = str_replace('%url%', $shareUrl, $body);
+
+ return 'mailto:?subject=' . rawurlencode($subject) . '&body=' . rawurlencode($body);
+ }
+
+ /**
+ * Get Pinterest url.
+ *
+ * @param string $shareUrl
+ * @param string $media
+ * @param string $description
+ *
+ * @return string
+ */
+ public function getPinterestUrl($shareUrl, $media, $description)
+ {
+ $shareUrl = $this->getCampaignUrl($shareUrl, 'pinterest', 'button', true);
+
+ return 'https://pinterest.com/pin/create/button/?url=' . $shareUrl .
+ '&media=' . rawurlencode($media) .
+ '&description=' . rawurlencode($description);
+ }
+
+ /**
+ * Get Facebook url.
+ *
+ * @param string $shareUrl
+ *
+ * @return string
+ */
+ public function getFacebookUrl($shareUrl)
+ {
+ $shareUrl = $this->getCampaignUrl($shareUrl, 'facebook', 'button', true);
+
+ return 'https://www.facebook.com/sharer/sharer.php?u=' . $shareUrl;
+ }
+
+ /**
+ * Get Twitter url.
+ *
+ * @param string $shareUrl
+ * @param string $title
+ *
+ * @return string
+ */
+ public function getTwitterUrl($shareUrl, $title)
+ {
+ $shareUrl = $this->getCampaignUrl($shareUrl, 'twitter', 'button', true);
+
+ return 'https://www.twitter.com?status=' . rawurlencode($title) . ' ' . $shareUrl;
+ }
+
+ /**
+ * Get WhatsApp url.
+ *
+ * @param string $shareUrl
+ *
+ * @return string
+ */
+ public function getWhatsAppUrl($shareUrl)
+ {
+ $shareUrl = $this->getCampaignUrl($shareUrl, 'whatsapp', 'button', true);
+
+ return 'whatsapp://send?text=' . $shareUrl;
+ }
+
+ /**
+ * Get Messenger url.
+ *
+ * @param string $shareUrl
+ *
+ * @return string
+ */
+ public function getMessengerAppUrl($shareUrl)
+ {
+ $shareUrl = $this->getCampaignUrl($shareUrl, 'messenger', 'button', true);
+
+ return 'fb-messenger://share/?link=' . $shareUrl . '&app_id=' . $this->facebookAppId;
+ }
+
+ /**
+ * Get campaign url.
+ *
+ * @param string $shareUrl
+ * @param string $campaign
+ * @param string $medium
+ * @param bool $encode
+ *
+ * @return string
+ */
+ public function getCampaignUrl($shareUrl, $campaign, $medium, $encode = false)
+ {
+ $delimiter = '?';
+
+ if (strpos($shareUrl, '?')) {
+ $delimiter = '&';
+ }
+
+ $shareUrl .= $delimiter . 'utm_source=' . $this->campaignSource
+ . '&utm_campaign=' . $campaign
+ . '&utm_medium=' . $medium;
+
+ if (!$encode) {
+ return $shareUrl;
+ }
+
+ return rawurlencode($shareUrl);
+ }
+}