Facebook generator

In this article

⚠️ 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.
  • 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

Give your APP a Display Name, click on Create App ID and pass the captcha security check.

Step 3

At  Facebook Login press Set Up.

Step 4

Choose Web as the platform.

Step 5

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

Step 6

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

Step 7

At your App go to the Settings menu (under the Facebook login menupoint). 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 8

Head to the main Settings (under the Dashboard menupoint) -> 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.
  • App Icon: choose an image for your App.
  • Business Use: select one of the options.
  • Category: pick any category.

Once you are done, press Save Changes.

Step 9

Copy out the App ID and App Secret.

Step 10

Paste them into Smart Slider's settings.

Step 11

Now you should decide which permissions you will need: 

  • Pages Read Engagement: You need this permission if you want to access datas of Facebook pages you created.
  • User Photos: You need  this permission to access photos of users, except your own user.
  • Step 12

    On the left side bar click on  App Review and select My Permissions and Features, then click on the Add additional permissions and features link.

    Step 13

    Request the permission you need: 

  • user_photos: You need this permission to  access photos of users, except your own user
  • 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 14

    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 15

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

    Step 16

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

    Step 17

    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 18

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

    Step 19

    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 20

    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.