getFacebookShares

Last updated Apr 21st, 2019 | Page history | Improve this page | Report an issue

Support the team building MODX with a monthly donation.

The budget raised through OpenCollective is transparent, including payouts, and any contributor can apply to be paid for their work on MODX.

Backers

Budget

$301 per month—let's make that $500!

Learn more

SocialSuite is a collection of useful tools for integrating various social media into your MODX website.

getFacebookShares is a snippet, part of SocialSuite, which returns a number indicating the amount of times a certain URL has been shared or commented on using Facebook.

Snippet Properties¶

Property	Default Value	Description
url	url of current resource	The url to find the amount of shares for. Note that this needs to be a full url, so when generating URLs using the `[[~]]` syntax, make sure to add &scheme=`full`, like this:
`[[~15? &scheme=`full`]]`
cache	true	If the result should be cached or not, on by default. Set to 0 to disable (not advised).
cacheExpires	3600	Time (in seconds) the cache is considered valid, and new data is retrieved from facebook.
node	shares	Change to "comments" to get a count of comments for the specific url, usually only available if you have a facebook comment widget on that page, note that this only seems to count root-level comments (so not replies to comments). You can also set this to "id" to see the url that Facebook is checking for.

Example Usages¶

Get the the amount of shares for the current resource:

[[!getFacebookShares]]

Get the amount of facebook comments for the current resource:

[[!getFacebookShares? &node=`comments`]]

Get the amount of facebook comments for a resource in a getResources tpl:

Comments: [[!getFacebookShares? &node=`comments` &url=`[[~[[+id]]? &scheme=`full`]]`]]

Get the amount of shares for the url "http://google.com/" and format it nicely using the prettyNumbers output filter that comes with SocialSuite:

[[!getFacebookShares:prettyNumbers? &url=`http://google.com/`]]

Run this snippet inside another snippet to get counts of a specific url:

<?php
$url = 'http://google.com/';
$shares = $modx->runSnippet('getFacebookShares', array('url' => $url));
return "The url {$url} has been shared {$shares} times on Facebook.";