Code customizations for date range, feed style, spacing, filtering and more

Mario

Updated 1 week ago

With easy changes to your Juicer embed code, you can unlock more customizations to your social feed.

Juicer offers feed customizations beyond what is shown in your dashboard. You can make these changes by adding code into the feed or script element of your Juicer embed code.

If you are using a standard website, with our new version of the snippet that improves the accessibility of the feed, below is an example of the line you will be working with. This example has customization included (in bold) that limits the number of posts shown to 15 and a Load More button will appear after those 15:

<script type="text/javascript" src="https://www.juicer.io/embed/YOUR-JUICER-FEED-NAME/embed-code.js?per=15" async defer></script>

The older snippet looks like this, so you can tweak it similarly, in case you still have that one (although we would advise you to update the embed snippet):

<ul class="juicer-feed" data-feed-id="YOUR-JUICER-FEED-NAME" data-per="15"></ul>

You can also still create your HTML element for the feed yourself with the new snippet, in that case, you would be using the same setup as for the <ul> element:

<div class="juicer-feed" data-feed-id="YOUR-JUICER-FEED-NAME" data-per="15"></div>

In your code, “YOUR-JUICER-FEED-NAME” will already have your unique feed ID shown.

In the later examples, we'll provide both the <script> and <ul> versions of the customizations.

If you are using the WordPress plugin and the corresponding Juicer shortcode or PHP function, the way you make these customizations will be slightly different. It will look like this:

[juicer name="YOUR-JUICER-FEED-NAME" per="15"]

⚠️ All data attributes in the WP shortcode, e.g., data-per, data-after, etc.,
can be used with or without the prefix data-. So, per, after, etc. is also OK.

Or, if you're using a PHP function:

<?php juicer_feed('name=YOUR-JUICER-FEED-NAME&per=1'); ?>

Finally, if you are using the iframe version of the Juicer embed code, you can make customizations by adding them like this example (with a question mark followed by the attribute):

<iframe ?per=1" frameborder="0" width="1000" height="1000"></iframe>

⚠️ If you want to add multiple customizations to the iframe code, simply add an & symbol between them.

The list of modifications we will cover here:

________________________________________________________

Change the number of posts displayed in the feed above the Load More button

Data Attribute: per
Default: 100
Example:
<script type="text/javascript" src="https://www.juicer.io/embed/YOUR-JUICER-FEED-NAME/embed-code.js?per=15" async defer></script>

The attribute per defines how many posts appear on each page of your Juicer feed. When you reach the bottom of a page of posts, Juicer will show a “Load More” button, or it will “infinitely scroll” if you have enabled this from your Feed Settings panel. If you do not want the feed to load more posts beyond the first page, see the “pages” attribute below.

Juicer shows 100 posts per page by default (or all your posts if you have fewer than 100).

Limit the number of total pages of your feed that can be loaded

Data Attribute: pages
Default: infinity
Example:

<script type="text/javascript" src="https://www.juicer.io/embed/YOUR-JUICER-FEED-NAME/embed-code.js?pages=1" async defer></script>

The pages attribute limits the number of times a visitor to your webpage can load more posts in your feed. By default, there is no limit, so the visitor can continue to load more posts until all of them have appeared.

If you don't want the visitor to load more than a single page of posts, simply set this attribute to 1. If you sent it to 2, the visitor can load an additional page of posts. And so on. You can combine this with the “per” attribute explained above to set the number of posts per page.

Limit the length of the post text and add a “Read More” link

Data Attribute: truncate
Default: infinity
Example:

<script type="text/javascript" src="https://www.juicer.io/embed/YOUR-JUICER-FEED-NAME/embed-code.js?truncate=500" async defer></script>

Truncate allows you to limit the number of characters that appear in each of your social posts before a “Read More” link appears. This is a way to bring more consistency to the size of your posts or to take up less space on your page overall. If a post is shorter than the number of characters you provide, it won't change.

Change the space between posts

Data Attribute: gutter
Default: 20 (or 0 on “image grid” style)
Example:

<script type="text/javascript" src="https://www.juicer.io/embed/YOUR-JUICER-FEED-NAME/embed-code.js?gutter=10" async defer></script>

The attribute gutter is the space between the posts in your feed in pixels. On the modern style, this defaults to 20, but you can edit this if you want to change the spacing.

Please note that this setting doesn't work for all feed styles, most notably slider.

Change the number of columns

Data Attribute: columns
Default: 3
Example:

<script type="text/javascript" src="https://www.juicer.io/embed/YOUR-JUICER-FEED-NAME/embed-code.js?columns=4" async defer></script>

This allows you to change the number of columns of posts within your feed. You can also edit this attribute in your feed dashboard (from the “Feed Settings” panel).

Juicer will not allow a column to be less than 200px because it becomes too difficult to see. Juicer has a responsive design – if your feed is appearing with too few columns, you may need to increase the size of the container on your webpage that is showing Juicer.

Change the timing of the widget or slider

Data Attribute: interval
Default: 5000
Example:

<script type="text/javascript" src="https://www.juicer.io/embed/YOUR-JUICER-FEED-NAME/embed-code.js?interval=1000" async defer></script>

The speed with which your slider or widget progresses, in milliseconds. By default, this is 5000 or 5 seconds. If you do not want the feed to advance on its own, simply set this to 0 or to a very high number. You can also change this from the “Interval” field in the Feed Settings panel of your Juicer dashboard.

Change the number of tiles shown on the theme "living wall"

Data Attribute: visible
Default: -
Note: Works only with the "living wall" theme
Example:

<script type="text/javascript" src="https://www.juicer.io/embed/YOUR-JUICER-FEED-NAME/embed-code.js?visible=12" async defer></script>

If you have numerous approved posts and wish to showcase them gradually, consider utilizing the visible attribute. In the provided code example, the attribute visible=12 is employed to exhibit 12 posts at a time on your living wall. When using this attribute, Juicer will randomly select 12 posts from the entirety of your approved posts. This stands in contrast to using the per attribute (e.g., per=12), which would solely display the most recent 12 posts. By utilizing the visible attribute, all of your approved posts are accessible, allowing feeds with smaller grids to showcase a diverse range of content.

Filter the posts based on a source in your “Social Media Sources” panel

Data Attribute: filter
Default: none
Example:

<script type="text/javascript" src="https://www.juicer.io/embed/YOUR-JUICER-FEED-NAME/embed-code.js?filter=Facebook" async defer></script>

Enter the name of a social network (capitalized) like “Facebook” or “LinkedIn” to only show posts from that network. If you have multiple sources from one network, it will display all of them.

Or, enter the name of the source account or hashtag, to only show posts from that particular source. For example, if you have an Instagram source of #tbt in your feed, you can pass in tbt to only show posts from that source.

You can filter for multiple sources by separating them with commas, like so:

data-filter="Source1, Source2”

For more complex source filtering situations (multiple accounts with the same name, etc.) please contact us for support. We can provide you with unique ID numbers for each source in your “Social Media Sources” panel, which can be used in this customization.

Please note that this customization will only filter based on your sources. It will not filter based on terms within the social posts. Use the filters in your “Moderate and Filter” panel to accomplish that.

Display posts in a certain date range

Data Attribute: starting-at and ending-at
Default: none
Example:

<script type="text/javascript" src="https://www.juicer.io/embed/YOUR-JUICER-FEED-NAME/embed-code.js?starting-at=2014-03-01&ending-at=2014-04-01" async defer></script>

Pass in a date in the format YYYY-MM-DD HH:MM (HH:MM optional) to either starting-at (show posts newer than this date) or ending-at (show posts older than this date). To filter by dates.

Use a different feed theme than the one set in the dashboard

Data Attribute: style
Default: none
Example:

<script type="text/javascript" src="https://www.juicer.io/embed/YOUR-JUICER-FEED-NAME/embed-code.js?style=slider" async defer></script>

If you want to use the same feed on different pages with different themes, you can pass in the name of the template in lowercase (“user”, “colors”, “classic”, “widget” etc.) as the style attribute to overwrite the template on a certain embed.

Open the overlay by clicking on a post

Data Attribute: overlay
Default: none
Example:

<script type="text/javascript" src="https://www.juicer.io/embed/YOUR-JUICER-FEED-NAME/embed-code.js?overlay=true" async defer></script>

Set to “true” if you want the feed to open an overlay when a post is clicked in your feed. If set to false, when you click on the post, it will instead take you directly to the post on the social media provider (except for LinkedIn posts, in which case it will take you to the LinkedIn Posts page). This can be set from your feed dashboard in the settings as well, but if you set it directly on your embed like outlined here, that will override your dashboard settings.

Run JavaScript after the feed has rendered

Data Attribute: after
Default: none
Example:

<script type="text/javascript" src="https://www.juicer.io/embed/YOUR-JUICER-FEED-NAME/embed-code.js?after=updateFilters()" async defer></script>

If you want to run some arbitrary JavaScript functions after the Juicer feed has rendered (likely to modify it) you can pass in the name of the function to the after attribute. The updateFilters() function written above is only an example.

‼️ Please note: The function runs after a feed is loaded, paginated or an overlay window is opened.
The first parameter of the callback function can help with detecting which of the cases it is. The parameter values are load, paginated and overlay accordingly.

Example: If you would like to catch only the pagination, our example function would start like this:

function updateFilters(eventType) {
  if (eventType == "paginated") {
    // Do your stuff here
  }
}

Using two or more parameters

💡 If you would like to join two or more different parameters, you can do it with an ampersand, i.e., & between them.

Example:

<script type="text/javascript" src="https://www.juicer.io/embed/YOUR-JUICER-FEED-NAME/embed-code.js?per=15&overlay=true" async defer></script>

If you have any questions or need any help, please email us at [email protected].

Did this answer your question?

😞 😐 😃

Juicer.io Support Center