Social Media Accounts

NeatClubs.COM supports three Facebook plug-ins as well as a new Twitter follow-me widget.

These integrations are distinct from the AddThis.COM integration.

While other plug-ins or widgets may be added by users comfortable editing HTML in the CMS, those directly enabled in NeatClubs.COM include the:

More information about these social media add-ons is available at the appropriate Facebook and Twitter web pages.

http://developers.facebook.com/docs/plugins/

http://twitter.com/about/resources/followbutton

http://www.google.com/+1/button/

Specifying Facebook and Twitter Account IDs

For best results, web-site administrators with Facebook accounts should specify their numeric Facebook ID number.

While not required, this ID indicates to Facebook that you are the administrator of the web-site.

Instructions how how to determine your Facebook Account ID are provided below.

http://www.ehow.com/how_5753004_facebook-id.html

For Twitter, you can simply use your Twitter account name as the Account ID.

Under System Setup / Preferences / Integrations, fill in the fields below and press Save Settings.

Setting the social media properties of documents

Social media features are enabled for individual documents only.

In future this will extended to include other types of NeatClubs.COM objects such as events and schedules.

To enable social media features on a web page, edit the document properties.

The five relevant properties are:

The Facebook Like, Facebook Send, Google +1 and Twitter Follow widgets will appear near the top of the web page with icons similar to the ones below.

If a website visitor already logged into Facebook and/or Twitter when they visit a NeatClubs.COM site with these features enabled, they will see information about friends who liked the site and whether they are already following the site on Twitter.

IMPORTANT: If you want people to be able to like your website and have the correct logo for your organization appear in Facebook, please make sure that an e-mail header graphic is specified under System Setup / Preferences / E-Mail. The Logo used at the top of outgoing e-mail messages is also used to broadcast your organization logo to Facebook.

Also, if you are experiencing errors when someone clicks on a Facebook Like button, please check the troubleshooting section at the end of this document. The Facebook administrator account ID specified to NeatClubs needs to "Like" the page as well. This is Facebook security requirement as they is how Facebook determines that the Facebook account holder has given consent for the use of their ID.

The Facebook send icon allows users to send a reference to the site using personal messages rather than posting a reference on their Facebook wall.

In the example below the website visitor is already following our named account on Twitter, but neither they nor any of their Facebook friends have liked the site.

If Facebook comments are enabled, these will appear at the bottom of the web page automatically.

For users not logged in to Facebook when they visit your site, they will have the opportunity to post feedback as below:

They can comment using any of their Facebook, Yahoo, AOL or Hotmail accounts to identify themselves.

If the site administrator is logged into Facebook with the Facebook account matching the administrator account ID identified in the system setup above, the administrator will be recognized as the moderator of any Facebook comments made on a page.

You will be able to see dialog related to your page and enter a moderator view to remove comments judged to be inappropriate.

You will also be able to view the dialog inside Facebook.

For Google Plus users not logged in, clicking the plus one icon will result in the Google +1 window below opening up and users will have the option of logging into their Google +1 account. For users who are already logged in, fields in your google plus circles will be aware of the fact that you "plus oned" the website.

Nitty Gritty Details

The NeatClubs.COM website provides Facebook with directions about how to interpret the site.

When someone likes a page on the web-site, Facebook uses information supplied by the NeatClubs software to control what graphic images and text to display inside Facebook.

Because of this, it is important that the descriptive text specified in System Setup / Preferences / Organization be setup accurately.

Left to its own devices, Facebook would normally pick a graphic from your web page that in its judgment represents your site, however in our experience Facebook can easily guess wrong.

For most organizations, a valid logo already exists as an e-mail header.

For simplicity, NeatClubs will suggest to Facebook that the graphic specified under System Setup / Preferences / E-Mail called "Graphic Header for Outbound Mail and Newsletters" be used to represent the web-site. If you are not happy with the Logo you can simply create a new logo and upload it as an image of type "E-Mail Header Graphic" and configure NeatClubs.COM to use this new graphic as the default.

For best results, this graphic should be approximately 150 x 150 pixels in size.

You can validate that NeatClubs is sharing correct information with Facebook by viewing the web page "source" and looking for meta tags in the HTML similar to the ones below.

The lines with properties starting with "og:" refer to Facebook's Open-Graph protol that defines how Facebook categorizes and represents objects.

You can learn more about the protocol here: http://developers.facebook.com/docs/opengraph/

Troubleshooting

Sometimes a page will be "liked" and Facebook will store an incorrect reference to the page.

For example the page image may be incorrect or the descriptive text may be incorrect.

Facebook caches this information, so even when you post a new image or descriptive text by changing NeatClubs settings as described above the old information can persist in facebook.

To force Facebook to re-scan your web-page, you can use a tool called the Facebook "URL linter".

http://developers.facebook.com/tools/lint/

Running this tool on a web-page forces Facebook to re-read and re-classify all content related to the site.

Sometimes Facebook will raise an exception when running Lint, but in our experience this seems not to matter.

For example, running the URL linter on our own web-site NeatWorx.COM is done as follows:

Running the Lint tool against the NeatWorx web-site will result in output similar to the following forcing the site definition inside Facebook to be updated.

According to the Facebook documentation, Facebook will stop updated site descriptions once the number of Likes reaches 50 for any given page to prevent confusing users who have already liked a web page.

Also, the Facebook account holder defined as the administrator is required to Like the page themselves.

Please note that the Input URL must exactly match the page that you are seeking to have Facebook re-scan since you may potentially have many pages on the site stored in Facebook.