Facebook generator

In this article

⚠️ The Facebook generator will be deprecated soon, so we don't suggest trying to create new ones anymore!
⚠️ Warning: Facebook has a lot of limitations related to their APPs, and here is a list of them: 
  • You need to have a HTTPS website, so an SSL certificate is required on your site. 
  • You need to submit your App for review. This means you need to write a reasoning why do you want to ask down those Facebook data you want to show and people at Facebook will decide whether you can use your application or not. This can take time. It's also important to know that we do not have control over this process by any means. If you want your app get approved, check out the App Review documentation people at Facebook put together. Follow each step carefully and you'll have better chances to get your app approved.
  • If you want to create Posts by page generator, or Photos by album generator where another user's photos are displayed, you need a verified Business account.
  • You need to manually request a new token in every two month. At our Global settings -> Generators -> Facebook our system will write out when that two month ends to help you track it.
☝️ Note: This generator is only available in the Pro version.

Tutorial

Step 1

Create an application at Facebook.

Step 2

If you want to use the Photos by album generator, choose Consumer app type.

If you want to use the Posts by page generator, choose Business app type.

Step 3

Give your APP a Display Name and click on Create App.

Step 4

At  Facebook Login press Set Up.

Step 5

Choose Web as the platform.

Step 6

Write your website's URL into the Site URL and press Save.

Only live url can be used. Localhost urls are not accepted by Facebook at later steps.

Step 7

Go to our Global Settings → Generators → Facebook and copy out the Callback url.

Step 8

At your App go to the Settings menu (under 'Facebook Login'). Insert the Callback URL from Smart Slider 3's backend to the Valid OAuth Redirect URIs field. Click Save changes at the bottom right corner.

Step 9

Go to  Settings (under 'Dashboard') -> Basic menupoint and set up these values:

  • App Domains: write your website's address here (without http or https).
  • Privacy Policy URL: write a live url here. On this page the privacy policy of your website should be, telling about what you will do with the received datas you have access to. If you don't have a privacy policy page, use your homepage url (or any live website's url) and later on if Facebook asks you to have a correct privacy policy page, you can replace this url.
  • User Data Deletion: choose Data Deletion Instructions URL and write a live url here. This page suppose to tell your users how their data can be deleted. For example a contact page to you.
    (This field only appears for Consumer app type.)
  • App Icon: choose an image for your App.
  • Category: pick any category.

Once you are done, press Save Changes.

Step 10

Copy out the App ID and App Secret.

Step 11

Paste them into Smart Slider's settings.

Step 12

If you want to create Posts by page generator, or Photos by album generator where another user's photos are displayed, you need a verified Business account. On the same Settings -> Basic page, under Business verification press Start Verification and go through the registration/verification process.

Step 13

Now you should decide which permissions you will need: 

  • Pages Read Engagement: You need this permission if you want to use Posts by page generator to access datas of Facebook pages you created. This permission requires a successful App Review before you can use it.
  • User Photos: turn this on, if you want to use the Photos by album generator.

Step 14

On the left side bar click on  App Review -> Requests -> Request Permissions and Features.

Step 15

Request the permission you need: 

For Photos by album generator:

  • If you only want to display your own user's photos, you don't need any permissions.
  • user_photos: You need this permission to access photos of other users.

For Posts by page generator:

  • pages_read_engagement: You need this permission if you want to access datas of Facebook pages you created
  • Page Public Content Access: You need this permission if you want to access datas of Facebook pages what you haven't created.
  • Step 16

    At the  Complete App Verification section, you need to write a short description for the Facebook associate who will review your App. You need to include details about how and where the reviewer can interact with your project where you use the requested permissions.
    At the  Requested Permissions and Features section, add details to why you want to request the given data.
    If you see the  Complete App Settings section that means some details for your App are still missing. In the list you will see the settings you need to fill.
    Finally you will have to wait until Facebook approves these submissions!

    Step 17

    Once your API is done, switch it to Live mode.

    Step 18

    Now you can go back to our settings to press Request token.

    Step 19

    Give permission to access the requested datas within the popup window.

    ⚠️ Warning: Facebook has a limitation, that you need to request a new token in every two month, and this cannot be done with a code, because the user interaction is needed at the agreement window, so you will have to request a new token in every two month (or sooner). Until then your slider will show the last slides it could create before the expiration. To help you keep track of this expiration time, you can click on the Notification center at the Global settings, and you will see when it will happen.

    Step 20

    Now the api is done, go to any Slider Settings page and add a new dynamic slide. Choose Facebook.

    Step 21

    Configuring the generator

    Set up your generator. Choose the settings you want. Popular options you probably want to configure: category where your content will be pulled from, the number of slides you want to have, the ordering of the content.

    You can also click on the View Records button to see the data you'll be creating your slide with.

    When you're done, click on Add.

    Step 22

    Editing the dynamic slide

    After you saved your generator, you'll be redirected to the Slide Editor to set up the look of your slide. You can create your content by using variables.

    Not sure what are the variables or how to use them? Learn how to work with variables.

    Photos by album

    Configuration

    You can use these options to set what you want your generator to show.

    Filter

    User or page

    A username, or the name of a Facebook page, from where you want to show the album.

    Album

    You can select either a Facebook album, or the timeline photos.

    Generator Settings

    Learn about the Generator Settings at the Generator Settings documentation.

    Variables

    These are the available variables you can use to build your dynamic slide content in the Slide Editor.

    Not sure what are the variables or how to use them? Learn how to work with variables.

    • image - The link of the image.
    • thumbnail - The link of the image's thumbnail.
    • title - The title of the image.
    • description - The description of the image.
    • url - URL to the image.
    • author_url - URL to the author of the image.
    • likes - Like count of the image.
    • icon - Facebook's image icon.
    • picture - Small version of the image.
    • source - Medium version of the image.
    • imageX - Different sizes of the image.

    Posts by page

    Configuration

    You can use these options to set what you want your generator to show.

    Filter

    Page

    The name of the Facebook page, from where you want to show the posts.

    Type

    You can choose to either show the posts, or the feed of that page.

    Remove special characters

    You can remove the special characters.

    Date format

    You can use any PHP date format.

    Date format

    You can use any PHP time format.

    Translate Date And Time

    Modify the date containing variables with from->to translations. This is a simple text replacement code. You can separate more translations with || signs between them. For example: Monday->Hétfő||Tuesday->Kedd||January->Január

    Generator Settings

    Learn about the Generator Settings at the Generator Settings documentation.

    Variables

    These are the available variables you can use to build your dynamic slide content in the Slide Editor.

    Not sure what are the variables or how to use them? Learn how to work with variables.

    • link - Link to the post.
    • description - The text of the post.
    • type - The type of the post, if it has an image, it's image type, if it has a video, it's video.
    • image - The image of the post.
    Did this answer your question? Thanks for the feedback There was a problem submitting your feedback. Please try again later.