getFacebookProfile

Last updated Oct 27th, 2020 | 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

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

getFacebookProfile is a snippet, part of SocialSuite, which returns all sorts of information about a user or page on Facebook.

Snippet Properties¶

Property	Default	Description
user		The username, ID or shortname of a user or page to look up information for.
cache	1	To cache or not to cache, that's the question. (set to 0 to disable caching)
cacheExpires	3600	Time in seconds for the cache to be valid.
showAvailableData	0	Enable this (by setting it to 1) to see a dump of all data available for the selected user. Helpful in choosing your placeholders.
toPlaceholders	0	Enable this (by setting it to 1) to set all data to placeholders so you can use them in existing markup. This will DISABLE parsing the chunk specified with &tpl.
toPlaceholdersPrefix	fb	A prefix to apply to placeholders when using toPlaceholders.
tpl		Name of a chunk to parse with the placeholders (when toPlaceholders=0).

Example Usage¶

[[!getFacebookProfile? &user=`modxcms` &showAvailableData=`1` &toPlaceholders=`1`]]

returns the following:

name = MODX
is_published = 1
website = https://modx.com/
username = modxcms
founded = November 2004
company_overview = MODX is the Content Management System that gives developers, designers and end-users the creative freedom and power to build and maintain websites and online applications with ease. Lose the limitations. There’s no steep learning curve, no cumbersome template language, and no awkward or restrictive structures forced on your site. MODX gives you the freedom to work your way and get things done.
products = MODX Evolution, MODX Revolution
about = MODX CMS is the Content Management System, framework and platform. https://modx.com/ MODX Revolution https://modx.com/download/
talking_about_count = 45
category = Software
id = 19110642979
link = http://www.facebook.com/modxcms
likes = 2348
cover.cover_id = 10150742956652980
cover.source = http://sphotos-d.ak.fbcdn.net/hphotos-ak-prn1/s720x720/559491_10150742956652980_2095164733_n.jpg
cover.offset_y = 0

And allows you to do something like this:

Facebook Name: [[!+fb.name]]<br />
Likes: [[!+fb.likes]]

which outputs something like this:

Facebook Name: MODX
Likes: 2348