Important: If using our "Custom Facebook Feed" plugin then you don't need to follow these directions unless you want to display events. Instead, you can use the easy "Log in and get my Access Token" button inside the plugin to get your own Access Token. If you want to display events from your Facebook page then you will need to follow the directions below to retrieve a token.
Creating a Facebook Developer Account
If you already have a Facebook Developer account then skip to step 7
To renew an existing token follow the steps here
1) Go to developers.facebook.com and click on Log In in the top right. Log in using your personal Facebook account. Note: You must use the username and password from your personal Facebook profile. Facebook doesn’t allow businesses to register as developers, only individuals.
2) If this is your first time signing in to the Facebook Developer portal then click on Register. Registering is a quick an easy process which will take less than a couple of minutes. If you’re already registered then you can skip ahead to step 7.
3) Accept the Facebook terms and click Next.
4) Enter your phone number to confirm your account.
5) Facebook will send you an automated text message containing a confirmation code. Enter it in the box and click Register.
6) You’re now registered as a Facebook Developer. Click Done.
Creating an App
7) Hover over My Apps and then click on Add New App.
8) If prompted, click on basic setup. Note, this isn’t always displayed so, if not, then you can skip to the next step.
9) Enter your app Display Name – this can be anything you like. Enter an email address and click Create App ID
10) Complete the Security Check and click Submit to complete the app setup.
Important: Leave the app in Development mode. Do not make it Live.
Note: Now that your app is set up, you do not need to go through Business Verification. This is only required for live public-facing apps, not for apps which are just used for internal use and left in development mode.
Retrieving a Page Access Token
11) Important: Make sure your app is in “Development mode” and not Live. Then, go to the Settings > Basic to get your app information.
12) Important: Copy and paste your App ID and App Secret (shown below) into the fields in the next step.
Note: Make sure to click “Show” next to your App Secret before copying.
13) Copy and paste your App ID and App Secret from step 12 above into the fields below, then proceed to the next step.
14) Go to developers.facebook.com/tools/explorer/ and select the same app you set up in step 7 from the Facebook App drop-down list show below:
15) Click Generate Access Token.
16) Click Continue as __ in the popup modal.
17) In the Permissions section copy and paste pages_read_user_content to add it as a permission to your app.
18) Click Generate Access Token again.
19) Click Continue as __ in the popup modal again.
20) Select ONE Facebook page that you want to display events from. Important: Do not select multiple pages from the list.
21) Click Done. Note: You can ignore the message which says Submit for Login Review. The app will stay in development mode and so doesn't need to be submitted for review.
22) Once you've completed the prompts this will then provide a temporary (1 hour) Access Token. Copy this temporary Access Token and paste it into the field in the next step to extend it so that it never expires.
23) Paste your Access Token from step 23 into the field below and click Extend my token.
24) Copy and Paste this token into the field labeled "Facebook Access Token" on the plugin's Settings page.
Using it in a shortcode
You can also use it in a shortcode by using the accesstoken shortcode setting.
Eg: [custom-facebook-feed id="YOUR_PAGE_ID" accesstoken="YOUR_ACCESS_TOKEN_HERE"].
Troubleshooting
If you're receiving the following error message:
(#10) To use 'Page Public Content Access', your use of this endpoint must be reviewed and approved by Facebook. To submit this 'Page Public Content Access' feature for review please read our documentation on reviewable features: https://developers.facebook.com/docs/apps/review.
Then check the following three things:
- That you are an admin of the Facebook page you're trying to display posts from
- That the app is in "Development" mode and not "Live"
- That you selected the correct app and Facebook page in steps 14 and 15
Renewing a Token
To extend an existing token so that it never expires please follow the steps here