zaengle/craft-sharingintents

Generate social sharing intent URLs

5.0.0-beta.2 2024-03-22 15:58 UTC

Requires

• php: ^8.2
• craftcms/cms: ^5.0.0-beta.6

Requires (Dev)

• craftcms/rector: dev-main
• friendsofphp/php-cs-fixer: ^3.0
• phpstan/phpstan: ^1.4
• vlucas/phpdotenv: ^3.0

MIT

• Zaengle Corp

• cms
• Craft
• craftcms
• craft-plugin
• sharing intents

README

Generate social sharing intent URLs

Requirements

This plugin requires Craft CMS 5.0.0-beta.6 or later.

Installation

cd /path/to/project
composer require zaengle/sharing-intents
./craft plugin/install sharing-intents

Sharing Intents Overview

Generate sharing URLs using web intents

Current providers:

• Facebook
• Twitter / X
• LinkedIn

Configuring Sharing Intents

Zero config :)

Using Sharing Intents

Templating uses craft.sharingIntents which has 3 methods:

facebook(), twitter(), linkedIn()

all three take the same params:

url <string> URL to share description <?string> optional description (only supported for twitter ATM, other providers won't break, it just won't affect the) extraParams <?array> K/V string pairs of other params to append to the url

{# get an intent URL #}
{{ craft.sharingIntents.facebook(entry.url) }}
https://www.facebook.com/sharer/sharer.php?u=https%3A//zaengle.com/blog/making-it-work-and-doing-it-right


{# pass an optional description (only supported for twitter ATM) #}
{{ craft.sharingIntents.twitter(entry.url, entry.description) }}
https://twitter.com/intent/tweet?url=https%3A//zaengle.com/blog/making-it-work-and-doing-it-right&text=My+awesome+title


{# arbitrary params! #}
{{ craft.sharingIntents.linkedIn(entry.url, null, { foo: 'bar' }) }}
https://www.linkedin.com/shareArticle?url=https%3A//zaengle.com/blog/making-it-work-and-doing-it-right&foo=bar

Sharing Intents Roadmap

• Release it
• Add more providers

Brought to you by Zaengle Corp