Facebook wall and social integration documentation for wordpresss

* To install pro version correctly remove the free version plugin by deactivating the plugin first and then deleting files completely, these options available in plugins page at admin dashboard. For any kinds of confusions and Errors, Read this doc and contact via our store website. CLICK HERE to see all shortcode attribute names which can be included in wordpress shortcode


To run the plugin you will need page/group/profile id, Access token. You can get these easily, Follow steps below -

Getting profile/page/group id

following are steps to get page/group/profile id -

(i) how to get facebook page id

Load your FB page. Your page id will be looked like as shown in the following image -

page id image
sometimes your page url may be like this - http://www.facebook.com/pages/pagename/334319236534?sk=wall , in this case your page id will be 334319236534. When you generate page token, you will be needed to enter numeric page id so if your page url look like this - https://www.facebook.com/anypagename then getting the id is little tricky - to get id load your fb page in a browser, right click on the page and select 'view source' to view your web page source, then find(ctrl+f) for 'page_id' and you will see 'page_id=34343434' somewhere, so your page id is 34343434. Always verify it's your page by loading page url putting page id in browser as follows - https://www.facebook.com/34343434/.

(ii) how to get facebook group id

Use this tool to get group id. You can also get group id by the following way - load your group, your group page url may be look like this - https://www.facebook.com/groups/343432222/ where 343432222 is the id. sometimes if your group page url look like this - https://www.facebook.com/groups/joomlanospam then getting the id is little tricky - to get id load your group page in a browser, right click on the page and select 'view source' to view your page source, then find(ctrl+f) for 'group_id' and you will see 'group_id=34343434' somewhere, so your group id is 34343434. Verify your group id is correct by loading the group url in a browser - https://www.facebook.com/34343434

(iii) how to get profile id

Attention: After facebook's breaking changes things are not working properly so i am trying to find a solution to display profile posts Displaying profile feed will not be good because of lots of restrictions and privacy, but still you can display lots of public posts and activities. If you created facebook application before 30th April 2014 and using it's token to display feed then to get profile id, login to your facebook account, go to profile page, your profile id will look like in the image below (example - mridulcs) or use this tool to get id.
If you created facebook application after 30th April 2014 and using it's token to display feed then you have to get profile id in a diffrent way under you new application, contact us for this. Verify your profile id is correct by loading your profile url in a browser - https://www.facebook.com/profile_id_here

profile id image

If sometimes you see 'no posts to share' in feed display then go to plugin settings and check for 'Show guest entries' field and increase number of posts value.


Getting Access token

You will need 'Access Token' to show feed. Without access token feed display will not work. Follow these steps to generate access token -

Attention : From 1st May, 2018 facebook made breaking changes because of FB cambridge analytica scandal. From now on app created after 1st may, 2018 need to be submitted for review to use specific permissions (Go to "app review" page from your app dashboard for details).

But good news is you can still display your page/group posts by making your app in development mode and generating token by the below steps. You have to be admin of your FB app and page/group. But you will have some request limits. So to overcome all problems you can just submit your app for review.

If your are displaying your own facebook page posts then you need to submit your app for review for manage_pages permission.
If your are displaying your own facebook group posts then you need to submit your app for review for Groups_API feature.

So if you know how to submit app for review then do so else i can help you, it's a very complex and time consuming process. At last step of it, You have to go through business verification or if you do not have business then you need to submit national/passport id for individual verification(it has little limitation). In case of business verification, you will be needed to submit your business info and images of your business documents like business license, Business utility or phone bill, Articles of incorporation document, Business tax file, certificate of formation, etc. You can submit all/some of these document images.

After your app review complete or your app is in development mode then follow these steps to generate token -

( If you display fb page posts then to get token follow step-3 or if you display group posts then follow step-4 or if you display profile posts then follow step-5 )

1. Login your facebook account -

2. Read the "How to create facebook application" section below to know how to create your facebook application and use it's app id and security code to generate access token.

3. If you are trying to display facebook page posts then you will need a page access token if you want to display post comments properly. So to generate page access token, go to access token tab in this plugin's settings page in your website's admin dashboard and follow these steps - (make sure your plugin's settings page url is https which is must for latest FB API changes, if you don't have free/paid https certificates for your site then contact me for the other way around)

** before generating page and user token by the following steps some settings should be done as follows -
a) if you are generating token and you don't own the facebook application by which you will generate token then you should be added as a tester role in the application. For this the application owner need to add you as tester role by clicking "Add Testers" in the "roles" section of the application. Easy to do, contact if any problems to do so.
b) if you are generating token and you don't own the facebook page and enter that page id in last steps of page token generation then you will get errors. So to overcome that problem ask the page owner to assign you any role from the "page roles" section of page settings.

Now the page/user token generation steps are -
(i) In access token tab, under "Generate new access token" section, Enter FB application id and secret key and press submit at first,
(ii) Then you will be asked to click submit button again in 2nd step if there are no errors,
(iii) Finally in 3rd step you will be asked to enter FB page id in numbers(at this step you can see generated user token in the input box), if you enter page id and click submit then you will see your page access token in response which is shown below as an example.
put this access token code in 'Access token' box in general settings tab and save your settings.

4. If you are displaying a Facebook group posts then you can either use a application token or page access token or user token. To generate page access token follow steps written in step-3 above. To generate user token follow step-3 above again(you will see user token in final step, FYI user token expires in every 2 months). To generate application token go to this token generation link here. FYI page and app tokens don't expire.

5. If you are displaying a Facebook profile posts then wait because after facebook's breaking changes things are not working properly so i am trying to find a solution.

How to create facebook application

Because of facebook's occassional layout changing, you may see little mismatch with the following images and steps for creating app and configuring. But you can still understand that easy process. Contact if any problems.
If you have not created facebook apps before or have not registerd as a developer then follow from step-1 below Else if you created apps or registered as developer before then start from step-3 -

step-1: go to this link - https://developers.facebook.com/apps

step-2: click "Register as a Developer"/"Register now" button.A popup will appear as shown below.There check the policy acceptance check box and click continue.
In the next step you will be prompted to verify your account by entering mobile phone number, following image shows that -

enter your mobile number and verify and clicking continue buttons complete rest of the steps by entering compulsory inputs.

step-3: If you completed step-2, you will see a "developer"/"Manage apps" section there at left side in home page of your facebook account.
click developer or Manage apps link or click here https://developers.facebook.com/apps to go to your apps page. there you will be seeing your created apps listed,
click 'Create a new app' button which is located under "Apps" menu item dropdown (Apps->Create a New App), following window will appear -


Enter display name(app name) and category only and leave other fields blank, then click "create app".Next you will be prompted to enter captcha as
security check and if you complete this, your app creation is complete and you will see that application's dashboard page as shown below.
this page also reachable from your account's home page developer/manage apps link or from here https://developers.facebook.com/apps and then by clicking on that app.

Now you have to do the real part.Click "settings" from app's left hand menu to go it's settings page, there in basic settings tab, click
"+ Add Platform" button at bottom and a pop up window comes up where a lot of platforms listed.Click "Website" in that popup then a website section will be added
as shown in the final picture below.After that in that section enter the site url in "Site URL" field from where you will generate access token. In that
case it will be your site url where you will be generating token by setting "Generate access token" view under "Module view settings" tab in module settings page in admin side of your website. Also in latest app you need to enter privacy policy url, enter your site's privacy policy url in privacy policy url box in basic settings of your App. After that click "save changes" at bottom to save changes for your app.


Finally, you need to make your app live so that it is accessible from anywhere to make feed display work unless you intentionally made app in development mode for app review issue.To do that make sure On/Off button is set as ON at top right side(where app status also shown) in your app dashboard.

In the above picture App ID and App Secret codes(click show button to see secret code) you will need to enter in the boxes in access token generation page.

That completes applicaton creation and configuring.

Errors details -

i) If you get error while generating token(for previous plugin version 1.0) like - "Given URL is not allowed by the Application configuration.: One or more of the given URLs is not allowed by the App's settings. It must match the Website URL or Canvas URL, or the domain must be a subdomain of one of the App's domains." That's because you haven't entered "Site URL" field of your application setting, as shown in the last image of last step for "How to create facebook application" section above.
ii) Why isn't the feed from my group/page displaying? -
Make sure system requirements are met(look for the tab in settings page), facebook id and access token are correct. Also, increase the Show number of posts value from settings becuase non-pro version only shows status/textual posts of page/group/profile so there may not be enough status posts in the number of posts value specified, make sure there are no restrictions set in facebook page/group settings comparing with other page/groups for which feed works, mainly remove country and age restrictions in page/group settings. If all failed, you have contact options.
iii) Why my facebook profile feed not displaying properly?
If you created facebook application after 30th April 2014 and using it's token then profile feed may not be displayed for new facebook Graph API.Actually Displaying feed for profile shows only public and selected posts because of various restrictions. So it's not good idea to show profile feed.
iv) Ppage/group profile picture not appearing or a question sign comes up-
it may be because of some restrictions you set in page/group/profile settings. For instance, in a page settings if "Age restrictions" setting is set to "Alcohol-Realted" then a question mark will appear instead profile picture. There may be other issues, contact us.
v) if you get Unsupported get request errors, then make sure the facebook id you entered is right
vi) like box is not appearing in my Group Wall Feed - like box is only for facebook pages not for groups
vii) only last two comments appear per post & "view all comments" button not appearing - That's because facebook deprecated some fields, There may be other issues, contact us.
viii) If you get errors related application like "Error validating application. Application has been deleted" - That's because the facebook application by which you generated access token is deleted. There are many reasons why app deleted like
1. facebook bugs
2. using the app to do facebook development not following policy - https://developers.facebook.com/policy/ properly like if you post or comment by same text( like "test comment") to a facebook page by graph api again and again in a short time, then it look like spammy to facebook, these kind of violations written indirectly in policy.

to be sure facebook application will not be deleted, don't use ur application by which you generated token for other developments improperly.
ix) If you get errors related with zip that you unable to unzip or the following error while installation - "The package could not be installed. PCLZIP_ERR_BAD_FORMAT (-10) : Invalid archive structure", it might be because of problems in zip program installed in your computer or no zip programs.To overcome problems follow either one of these ways -

a) install winrar zip program ( http://www.win-rar.com/download.html ), then unzip the plugin using it (if you can't open zip to unzip, right click on it and click Extract files to unzip it), inside you will find main installation
zip - "facebook-wall-and-social-integration_v1.0.zip", install it via wordpress.If installation failed then unzip this main zip and again rezip using winrar. Make sure under that new zip - "facebook-wall-and-social-integration_v1.0.zip"
there is only one folder "facebook-wall-and-social-integration" and contents inside it, now go on and install it.

b) If step [a] above fails, create a folder giving this name - "facebook-wall-and-social-integration". Unzip the main plugin zip file as written above, you see there is a folder(facebook-wall-and-social-integration) within,
copy the content of the folder into your newly created folder("facebook-wall-and-social-integration") and zip it again. Make sure this new zip name is same as plugin name(ex - facebook-wall-and-social-integration.zip)
and inside of the zip there are content directly not under another folder, install this zip via wordpress.

c) Also anoher way of installing may be by creating a folder named "facebook-wall-and-social-integration" directly in your website file system under "wp-content\plugins\" folder from hosting
control panel or via FTP. After that copy the content of "facebook-wall-and-social-integration" folder in the MAIN PLUGIN ZIP file (as written in step - [a] above) into the created folder
"wp-content\plugins\facebook-wall-and-social-integration\" Then activate the plugin from the plugins menu in wordpress admin dashboard.
x) How you get post id to filter posts by post id? click the date on any post in facebook then it will be loaded as a single post, there look for the post id in the url in numbers. In case of page post sometimes thare are multiple ids in the url, look for "story_fbid" value. FB may change things in a future time, use google to get post id.

For more help email at - mridulcs2012@gmail.com, mridulcs@yahoo.com

For chat skype/yahoo messanger id - mridulcs