PHP Social Stream is the best choice for those who are looking for an easy way to share their social networking updates on their website.
This script gives you a combined social media stream for all of your social network updates, and can display them in 6 different formats: Wall, Timeline, Rotating Feed, Sticky Rotating Feed, Ajax Tabbed Feed & Sticky Ajax Tabbed Feed. It supports 17 and growing social networks and includes about 30 feed options.
Your visitors will be able to share your posts on Facebook, Twitter, Google or Linkedin from your website. They will also have the option to reply, retweet or favorite the Twitter posts on your Social Stream and watch the YouTube or Vimeo videos in a light box window. They can even filter your social stream by social network.
You can also change the style of your stream using the theme configuration file and/or custom CSS stylesheets, and make it unique to your website.
PHP Social Stream
Created By: Axent Media
Created On: 10 July 2015
Last Update: 10 April 2018
Version: 2.6.2
If you have any questions or suggestions concerning to PHP Social Stream script, please contact us via our page on CodeCanyon http://codecanyon.net/user/axentmedia or via our website at http://axentmedia.com/
Note: We provide free installation and configuration for clients. After your purchase, simply contact our support desk and provide us your website information to get this service for free.
Wall Demo 1 – Modern layout – Light skin
Wall Demo 2 – Metro layout – Dark skin
Wall Demo 3 – Flat layout
Wall Demo 4 – Default layout – Random order
Media Wall Demo
Social Tag Board Demo
Rotating Feed Demo 1 – Modern layout
Rotating Feed Demo 2 – Default & Flat layouts
Carousel Feed Demo 1 – Modern 2 layout
Carousel Feed Demo 2 – Modern layout
Installation of PHP Social Stream is straight forward and on average should take no longer than just a few minutes.
1. Open and extract the PHP Social Stream zip compressed file that you have downloaded from CodeCanyon to a location on your computer.
2. Find, extract and upload the contents of the php-social-stream-x.x.zip
file to the root or subfolder of your site where you'd like the script to be accessible.
3. Open the social-stream/config.php
file and do the following required setup:
SB_PATH
=> Path to script directory (non-relative).
SB_LOCALE
=> Define your locale language - Available options are described in the config file - e.g de_DE
.
SB_NONCE_KEY
=> Replace this with a different unique phrases - This is for Ajax requests security.
$GLOBALS['api']
=> Important: Replace this with your API Credentials - Read this topic to find out more about API Credentials.
Now you have installed the PHP Social Stream script. Follow the Quick Start Guide process to create a sample Social Stream enabled page.
After installation, you would have to create your Social Stream. Here we will explain you that how to create different form of feeds with the default settings and your relevant social network IDs on your website.
In this topic we create a combined social stream wall on our website.
<?php
include( './social-stream/social-stream.php' ); // Path to PHP Social Stream main file
?>
<?php
echo social_stream(
array(
'id' => '1',
'type' => 'wall',
'network' => array(
'facebook' => array(
'facebook_id_1' => array(
'624290390999239' // Replace with your Facebook page ID
),
'facebook_pagefeed' => 'posts'
),
'twitter' => array(
'twitter_id_1' => array(
'mashable' // Replace with your Twitter username
),
'twitter_images' => 'small',
'twitter_feeds' => 'retweets,replies'
),
'google' => array(
'google_id_1' => array(
'112592709425670873637' // Replace with your Google+ profile ID
)
),
'tumblr' => array(
'tumblr_id_1' => array(
'ghostphotographs' // Replace with your Tumblr username
)
),
'pinterest' => array(
'pinterest_id_1' => array(
'2013TopPins' // Replace with your Pinterest username
)
)
),
'theme' => 'sb-modern-light',
'itemwidth' => 250,
'results' => 30,
'debuglog' => 0,
'add_files' => true
)
);
?>
Your social wall is ready now. Browse to your created PHP document on your website to view the created Social Stream Wall.
For more information about creating/customizing a Social Stream click here.
In this example we create a combined social stream wall with multiple hashtags and usernames.
<?php
include( './social-stream/social-stream.php' ); // Path to PHP Social Stream main file
?>
<?php
echo social_stream(
array(
'id' => '1',
'type' => 'wall',
'network' => array(
'twitter' => array(
'twitter_id_1' => array(
'axentmedia' // Twitter username 1
),
'twitter_id_3' => array(
'#paris', // Twitter hashtag 1
'#media' // Twitter hashtag 2
),
'twitter_images' => 'small',
'twitter_feeds' => 'retweets,replies'
),
'instagram' => array(
'instagram_id_1' => array(
'self', // Your Instagram account - It will use the Access Token that is set in config.php file.
'Access Token from another Instagram account you want to get its feed'
),
'instagram_id_2' => array(
'socialmedia' // Instagram hashtag 1
'selfie', // Instagram hashtag 2
)
)
),
'theme' => 'sb-modern-light',
'itemwidth' => 250,
'results' => 30,
'debuglog' => 0,
'add_files' => true
)
);
?>
In this topic we create a combined social stream timeline on our website.
The process is the same as you did for the Social Wall instead you will replace the 'type' => 'timeline'
in the code.
<?php
include( './social-stream/social-stream.php' ); // Path to PHP Social Stream main file
?>
<?php
echo social_stream(
array(
'id' => '1',
'type' => 'timeline',
'network' => array(
'facebook' => array(
'facebook_id_1' => array(
'624290390999239' // Replace with your Facebook page ID
),
'facebook_pagefeed' => 'posts'
),
'twitter' => array(
'twitter_id_1' => array(
'mashable' // Replace with your Twitter username
),
'twitter_images' => 'small'
),
'google' => array(
'google_id_1' => array(
'112592709425670873637' // Replace with your Google+ profile ID
)
)
),
'theme' => 'sb-modern-light',
'results' => 30,
'debuglog' => 0
)
);
?>
Your social timeline is ready now. Browse to your created PHP document on your website to view the created social stream timeline.
For more information about creating/customizing a Social Stream click here.
In this topic we create a combined social stream rotating feed on our website.
<?php
include( './social-stream/social-stream.php' ); // Path to PHP Social Stream main file
?>
<?php
echo social_stream(
array(
'id' => '1',
'type' => 'feed',
'network' => array(
'facebook' => array(
'facebook_id_1' => array(
'624290390999239'
),
'facebook_pagefeed' => 'posts'
),
'twitter' => array(
'twitter_id_1' => array(
'mashable'
),
'twitter_images' => 'small'
),
'instagram' => array(
'instagram_id_1' => array(
'self'
)
)
),
'theme' => 'sb-modern-light',
'label' => 'On Social Media',
'showheader' => 1,
'width' => 280,
'height' => 600,
'results' => 30,
'cache' => 360,
'debuglog' => 0
)
);
?>
Your social rotating feed is ready now. Browse to your created PHP document on your website to view the created social stream timeline.
For more information about creating/customizing a Social Stream click here.
In this topic we create a sticky rotating feed on our website.
<?php
include( './social-stream/social-stream.php' ); // Path to PHP Social Stream main file
?>
<?php
echo social_stream(
array(
'id' => '1',
'type' => 'feed',
'network' => array(
'facebook' => array(
'facebook_id_1' => array(
'624290390999239'
),
'facebook_pagefeed' => 'posts'
),
'twitter' => array(
'twitter_id_1' => array(
'mashable'
),
'twitter_images' => 'small'
)
),
'theme' => 'sb-modern-light',
'label' => 'On Social Media', // Label for the block header
'position' => 'sticky', // Important to make a floating block
'location' => 'sb-bottom_left', // Location of the block
'slide' => 1, // To enable slide in/out feature
'autoclose' => 1, // To enable slide auto-close feature
'showheader' => 1,
'width' => 250,
'height' => 400,
'results' => 30,
'cache' => 360,
'debuglog' => 0
)
);
?>
In this topic we create an ajax tabbed feed on our website.
<?php
include( './social-stream/social-stream.php' ); // Path to PHP Social Stream main file
?>
<?php
echo social_stream(
array(
'id' => '1',
'type' => 'feed',
'network' => array(
'facebook' => array(
'facebook_id_1' => array(
'624290390999239'
),
'facebook_pagefeed' => 'posts'
),
'twitter' => array(
'twitter_id_1' => array(
'mashable'
),
'twitter_images' => 'small'
)
),
'theme' => 'sb-modern-light',
'position' => 'normal', // Important to make a non-floating block
'label' => 'On Social Media', // Label for the block header
'tabable' => 1, // Important to make an ajax tabbed feed block
'showheader' => 0,
'width' => 250,
'height' => 400,
'results' => 30,
'cache' => 360,
'debuglog' => 0
)
);
?>
The PHP Social Stream by default, use a predefined settings for displaying.
To override these default options and customize your Social Stream, you can pass the relevant inline parameters in the social_stream()
function as follows:
These parameters can be used for all type of display modes.
Parameter | Default Value | Alternative Values | Description |
---|---|---|---|
id | '1' | 1 - ∞ | Unique ID Unique ID for the social stream instance. Useful, when you want to have multiple instance of a social stream in the same page. |
type | 'wall' | wall, feed, timeline | Type of social stream wall - Wall displaying modefeed - Rotating Feed displaying modetimeline - Timeline displaying mode |
network | Social Network IDs An array of social stream network feed sources - Click here for more details. |
||
theme | 'sb-modern-light' | sb-modern-light, sb-metro-dark, sb-modern2-light, sb-default-light, sb-flat-light, sb-modern-dark | Stream Theme Select a theme to style your Social Stream. You can have as many as custom themes you like in the config.php file. |
layout_image | imgexpand | imgexpand, imgnormal | Item image style This will define, how to display the image for each item on the Social Wall. |
layout_user | userpic | userpic, usernopic | User info position This will define, how to display the user info for each item on the Social Wall. Picture will be only displayed if exists! |
results | 30 | 0 - 100 | Results Limit Limiting the maximum number of results to display on social stream - Maximum 100. Note: There is a restriction for number of feed output results on each social network. For example, if you enter 100 as "Results Limit", you will only get 50 items from YouTube in each request. Facebook Group: 20, Tumblr: 50, Pinterest = 25, YouTube: 50, Vimeo: 20, Stumbleupon: 10, Deviantart: 60, RSS: 10 mostly. |
words | 40 | Words Limit Limiting the description words count to display for each item on social stream - Leave empty for no limit. |
|
commentwords | 20 | Comment Words Limit Limiting the comment words count to display for each item - Leave empty for no limit. |
|
titles | 15 | Title Limit Limiting the title words count to display for each item on social stream - Leave empty for no limit. |
|
slicepoint | 300 | Slice Point Limiting the description characters count to display for each slide on slide show - Leave empty for no limit. |
|
readmore | true | true, false | Read more Link long blocks of text - If checked, the (…) character at the bottom of each feed item will be linked to the rest of the content. |
order | 'date' | date, random | Ordering Select whether to order the results depending on date or randomly. |
loadmore | true | true, false | Load more Load more social items (Next page) - If checked, a load more bar will appear at the bottom of the social network wall and loads more social items if clicked. |
links | true | true, false | Links Open Links In New Window - If checked, all links will open in a new window else they will be open in the parent window. |
nofollow | true | true, false | Nofollow links Add nofollow attribute on links - If checked, all links will have the status of nofollow. |
https | false | true, false | Use https Load images over https - If checked, all links and images will be getting over https. |
iframe | 'media' | media, slide, off | Lightbox content media - Only open media in a lightbox window.slide - Open all items detailed information as slideshow.off - Disabled |
slideshow | false | false, true | Auto Slideshow iframe = 'slide' - Only if iframe is set to slide. |
slideshowSpeed | '30000' | 0 - | Slideshow Speed iframe = 'slide' - Only if iframe is set to slide. |
filters | true | true, false | Filter networks If checked, a navigation bar of all active network icons will appear at the bottom of the rotating feed or above the social network wall. These icons will allow the user to filter the social stream items. |
default_filter | '' | '', facebook, twitter, google, tumblr, delicious, pinterest, flickr, instagram, youtube, vimeo, stumbleupon, deviantart, rss, soundcloud, vk, linkedin, vine | Filtered by default Which filtering button to be selected by default. '' - Show All
|
filters_order | 'facebook,twitter,google,tumblr,delicious,pinterest,flickr,instagram,youtube,vimeo,stumbleupon,deviantart,rss,soundcloud,vk,linkedin,vine' | Filter networks ordering - Enable/Disable networks buttons Order of the filtering navigation bar that appear at the bottom of the rotating feed or above the social network wall. You can also enable/disable networks filtering buttons. |
|
live | false | Stream Auto Update If enabled, the social board will get updated automatically without the need to refresh the page - If enabled, the "Cache Time" value will be ignored and considered as 0 . |
|
live_interval | 1 | Auto update interval The time delay for updating the Social Boards (in minutes). Considering that there are some limits on social networks about the number of requests sent to their API, the minimum allowed value is 1 . |
|
cache | 360 | Cache Time The time delay for caching of Social Streams (in minutes) - reduces up download time. 0 Zero value means no caching. Make sure the `cache` folder inside the script folder is writable by the server (depending on your web hosting server, permissions set to 755, 775, or 777). |
|
crawl | 10 | Crawl per request Number of feed crawls per each request. 0 Zero value means to crawl all at once. (depending on your web hosting server resources, some servers can not read a lot of feeds at the same time). |
|
debuglog | false | true, false | Debug Log Enable/disable debuging log - If set to true, all script errors will be logged in a file named "log.txt" in script folder. Make sure the `log.txt` file inside the script folder is existed and writable by the server (depending on your web hosting server, permissions set to 644, 655, or 666). |
display_ads | true | true, false | Display Ads Enable/disable displaying advertisements - If set to true, the ads (see Manage Ads section) will be displayed on your stream. |
filtering_tabs | Filtering Tabs Allows you to define custom filtering buttons to filter your wall items using different search terms. See Custom Filtering section for more details and example. |
Example Code:
The following code, creates a social network wall in Flat style, displaying the last 30 items of your feeds randomly.
<?php
include( './social-stream/social-stream.php' ); // Path to PHP Social Stream main file
echo social_stream(
array(
'id' => '1',
'type' => 'wall',
'network' => array(
'facebook' => array(
'facebook_id_1' => array(
'624290390999239' // Replace with your Facebook page ID
),
'facebook_pagefeed' => 'posts'
)
),
'theme' => 'sb-flat-light',
'order' => 'random',
'itemwidth' => 250,
'results' => 30,
'add_files' => true
)
);
?>
These parameters can be used only for Wall display mode.
Parameter | Default Value | Alternative Values | Description |
---|---|---|---|
transition | 400 | Transition Duration Duration of the transition when items change position or appearance - in milliseconds - 0 means no transitions. |
|
stagger | Stagger Staggers item transitions, so items transition incrementally after one another - in milliseconds - Leave empty to disable it. |
||
originLeft | true | true, false | Filter Direction Let layout to start render from left to right or, right to left. |
fixWidth | false | true, false | Fixed Width If enabled, the "Item Width" value will be applied to each wall item - Responsive Breakpoints will be ignored. |
breakpoints | array('5', '4', '4', '3', '2', '2', '1') | Responsive Breakpoints Defines the number of items (columns) shwoing on each row for different viewport sizes - Requires "Fixed Width" to be disabled. |
|
itemwidth | 230 | Item Width Width of feed item (px) - Do not leave empty! |
|
gutterX | 10 | Gutter X The horizon spacing between the column - Leave empty for auto value. |
|
gutterY | 10 | Gutter Y The vertical spacing between the row - Leave empty for auto value. |
|
filter_search | true | true, false | Search Filtering If enabled, a search box will appear above the social network wall allowing the user to filter the social stream items using a search phrase. |
wall_relayout | '' | '', imgload | Re-layout wall based on If "Page scroll" is enabled, the wall gaps will get filled when the visitor scroll the page but, if "Images load" is enabled, the wall gaps will get filled when a new image on the wall is loaded. '' - Page scroll
|
Example Code:
The following code, creates a social network wall in Modern style, rendering from right to left without animation.
<?php
include( './social-stream/social-stream.php' ); // Path to PHP Social Stream main file
echo social_stream(
array(
'id' => '1',
'type' => 'wall',
'network' => array(
'facebook' => array(
'facebook_id_1' => array(
'624290390999239' // Replace with your Facebook page ID
),
'facebook_pagefeed' => 'posts'
)
),
'theme' => 'sb-modern-light',
'filter_direction' => true,
'animate' => false,
'itemwidth' => 250,
'results' => 30,
'add_files' => true
)
);
?>
These parameters can be used only for rotating feed display mode.
Parameter | Default Value | Alternative Values | Description |
---|---|---|---|
rotate_speed | 100 | Animation Speed Defines the animation speed (in ms) of the rows moving up or down. |
|
duration | 4000 | Animation Duration Defines the times (in ms) before the rows automatically move. |
|
direction | 'up' | up, down | Animation Direction Sets the direction of rotating feed movement to either "up" or "down". |
controls | true | true, false | Controls Stop/start rotating - If checked, a feed control bar will appear at the bottom of the rotating feed allowing user to stop/start the rotating feed or go to next/previous item. |
autostart | 1 | 1, 0 | Auto Start rotating Enable/disable auto start on load. |
pauseonhover | 1 | 1, 0 | Pause On Mouse Hover Enable/disable pause when mouse hovers the rotating feed element. |
width | 250 | Block Width Width of feed block (px) - Leave empty for full width. |
|
height | 400 | Height Height of widget (px) - Leave empty for no height. |
Example Code:
The following code, creates a social network feed in Default style, moving from up to down that do not automatically start rotating on load.
<?php
include( './social-stream/social-stream.php' ); // Path to PHP Social Stream main file
echo social_stream(
array(
'id' => '1',
'type' => 'feed',
'network' => array(
'facebook' => array(
'facebook_id_1' => array(
'624290390999239' // Replace with your Facebook page ID
),
'facebook_pagefeed' => 'posts'
)
),
'theme' => 'sb-default-light',
'autostart' => 0,
'direction' => 'down',
'itemwidth' => 250,
'add_files' => true
)
);
?>
These parameters can be used only for carousel display mode.
Parameter | Default Value | Alternative Values | Description |
---|---|---|---|
cs_speed | 400 | Animation Speed Defines the animation speed (in ms) of the rows moving left or right. |
|
cs_pause | 2000 | Transition Speed The time (in ms) between each auto transition. |
|
autoWidth | false | true, false | Auto Width If enabled, the "Item Width" value of the General Setting will be applied to each slide - Number of items will be ignored. |
cs_item | array('4', '3', '2', '2', '1') | Number of items Defines the number of items shwoing in each slide for different viewport sizes - Requires Auto Width to be OFF. |
|
cs_width | 250 | Slide Width Width of slide item (px) - Do not leave empty! |
|
cs_rtl | false | true, false | Animation Direction Sets the direction of carousel feed movement to either "right" or "left". |
cs_controls | true | true, false | Controls Prev/next buttons - If checked, prev/next buttons will be displayed. |
cs_auto | false | true, false | Auto Start If checked, the Slider will automatically start to play. |
cs_loop | true | true, false | Loop slide If checked, will enable the ability to loop back to the beginning of the slide when on the last element - Slide Move will be ignored. |
cs_pager | false | true, false | Enable pager Enable/disable pager option. |
slideMove | 1 | Slide Move Number of slides to be moved at a time - Requires Loop slide to be OFF. |
|
slideMargin | 10 | Slide Margin Spacing between each slide. |
These parameters can be used only for Timeline display mode.
Parameter | Default Value | Alternative Values | Description |
---|---|---|---|
onecolumn | false | true, false | Display layout To display timeline in one column or based on browser screen width. |
In this section you will find the options that allow you to set up the social networks that you want to include in your Social Stream.
To add a specific social network feed to your Social Stream, you need to declare it using an option (ID, username, search term, etc) depending on type of the network.
Some social networks have multiple type of feeds available. You are required to use at least one of the options available for the social network feed to make it available in your Social Stream output.
The content blocks that you want to be included in each item on the Social Stream. Each social network may have different type of content blocks available.
title
=> Feed item title
thumb
=> Display thumbnail - if available
text
=> Feed item posted text
stat
=> Display stat block
comments
=> Display post/photo comments
likes
=> Display post/photo likes
user
=> Display user name
share
=> Include sharing links
info
=> Feed item icon & date
meta
=> Feed item meta data
tags
=> Feed item tags
Facebook requires a valid access token to provide the feed's data. Click here for more details.
Facebook provides 4 different feed options:
Parameter | Default Value | Alternative Values | Description |
---|---|---|---|
facebook_id_1 | 1. Facebook Page Feed The feed of posts (including status updates), photos and links on this page. Enter the page ID - e.g. 624290390999239 . You can find it in your Facebook page setting tab or obtain it from this website |
||
facebook_pagefeed | 'feed' | posts, tagged, feed | Specific sets of posts posts => Show only the posts that were published by this pagetagged => Show the posts that this page was tagged in and the (posts to page)feed => Show both
|
facebook_id_2 | 2. Facebook Group Feed The feed of posts (including status updates), photos and links on this group. Enter the group ID - e.g. 7091225894 . You can find it in your Facebook group setting tab or obtain it from this website |
||
facebook_id_3 | 3. Facebook Album/Page Photos Shows all photos this page is tagged in. Enter the album ID - e.g. 947092091976094 or the page ID - e.g. 182472465104731 . Read this topic on how to find a Facebook album ID. |
||
facebook_id_4 | 4. Facebook Page Videos Shows all videos this page is tagged in. Enter the page ID - e.g. 624290390999239 . Read this topic on how to find a Facebook page ID. |
||
facebook_datetime_from | Date Time From Get posts in a certain date/time from Facebook feed. Format: 'YYYY/MM/DD - e.g. '2015/07/10' or with time included '2015/07/10 4:30' |
||
facebook_datetime_to | Date Time To Get posts in a certain date/time from Facebook feed. Format: 'YYYY/MM/DD - e.g. '2015/07/30 0:00' |
||
facebook_comments | 3 | Comments Count Enter the number of comments to display for facebook album photos Set to 0 to disable comments. |
|
facebook_likes | 5 | Likes Number of likes to display - set to 0 to disable likes. |
|
facebook_image_width | 300 | Image width 300 => Tiny - 300px 480 => Very Small - 480px 640 => Small - 640px 720 => Medium - 720px 800 => Large - 800px 960 => Larger - 960px 1280 => X-Large - 1280px 1600 => XX-Large - 1600px |
|
facebook_video_width | 720 |
Video width |
|
facebook_output | 'title,thumb,text,comments,likes,user,share,info' | title, thumb, text, comments, likes, user, share, info | Social Stream Item Output Read the Common Feed Options section for more details. |
Method 1:
You can find it in your Facebook page/group setting.
Method 2:
Obtain it from this website (Page or Group ID both).
Or, from this website (Page ID only).
Method 3:
Type in the following URL in your web browser: https://graph.facebook.com/username
Replace “username” with the name of your Facebook page profile. It should churn out a result including your page ID.
Browse to your Facebook photos page and click on Albums - e.g. https://www.facebook.com/envatomarket/photos_stream?tab=photos_albums
Select an album - e.g. https://www.facebook.com/media/set/?set=a.676459932448951.1073741828.624290390999239&type=3
The album ID is the first set of numbers - in the example above, the album ID would be - 676459932448951
Twitter requires authentication to provide the feed's data. Click here for more details.
Twitter provides 3 different feed options:
Parameter | Default Value | Alternative Values | Description |
---|---|---|---|
twitter_id_1 | 1. Twitter Username Enter a Twitter username without "@" - e.g. username |
||
twitter_id_2 | 2. Twitter List To show a Twitter list enter the list ID - e.g. 123456 or enter the owner screen name, then "/" followed by the list slug "username/list_name" - e.g. mashable/social-media |
||
twitter_id_3 | 3. Search Term/Hashtag To search enter the search term - e.g. socialmedia or hashtag - e.g. #socialmedia |
||
twitter_since_id | Since ID |
||
twitter_max_id | Max ID Returns results with an ID less than (that is, older than) or equal to the specified ID - e.g. 605472728351707186 |
||
twitter_images | 'small' | thumb, small, medium, large | Image width thumb => Thumb - 150pxsmall => Small - 340pxmedium => Medium - 600pxlarge => Large - 1024px
|
twitter_feeds | 'retweets,replies' | retweets, replies | Feed Data retweets => Retweets - Include feed item retweetsreplies => Replies - Include replies
|
twitter_output | 'thumb,text,user,share,info' | thumb, text, user, share, info | Social Stream Item Output Read the Common Feed Options section for more details. |
Browse to your Twitter page - e.g. https://twitter.com/axentmedia
The Twitter username is the last word in the URL - in the example above, that would be - axentmedia
605472728351707136
Instagram requires your API Access Token to provide the feed's data. Click here for more details.
Instagram provides 4 different feed options:
Parameter | Default Value | Alternative Values | Description |
---|---|---|---|
instagram_id_1 |
1. Instagram Username Get the most recent media published by the owner of the Access Token. self => To get the feed from owner of the Access Token that is set in config.php file.Access Token string => Access Token from another Instagram account you want to get its feed.Endpoint: users/self/media/recent |
||
instagram_id_2 |
2. Instagram search tag To search by tag enter the tag name (contiguous) - e.g. paris Endpoint: tags/{tag-name}/media/recent |
||
instagram_id_3 |
3. Instagram location ID To show the latest posts by a location, enter the location ID - e.g. 12345 Endpoint: locations/{location-id}/media/recent |
||
instagram_id_4 |
4. Instagram geographical location To search by geographical location start with the latitude, longitude and distance in meters (up to a maximum of 5000) all separated by a "," - e.g. 48.858844,2.294351,2000 Read this topic on how to find, latitude and longitude coordinates of a location. Endpoint: media/search |
||
instagram_images | 'low_resolution' | thumbnail, low_resolution, standard_resolution | Image width thumbnail => Thumbnail - 150pxlow_resolution => Low Resolution - 306pxstandard_resolution => Standard Resolution - 640px
|
instagram_comments | 3 | Comments Number of comments to display - set to 0 to disable likes. |
|
instagram_likes | 5 | Likes Number of likes to display - set to 0 to disable likes. |
|
instagram_output | 'title,thumb,text,comments,likes,user,share,info' | title, thumb, text, comments, likes, user, share, info, tags | Social Stream Item Output Read the Common Feed Options section for more details. |
Google+ requires an API Key to display feed data. Click here for more details.
Google+ provides 1 feed option:
Parameter | Default Value | Alternative Values | Description |
---|---|---|---|
google_id_1 | Google Profile ID Enter your Google+ profile ID - e.g. 112592709425670873637 |
||
google_output | 'title,thumb,text,stat,user,share,info' | title, thumb, text, stat, user, share, info | Social Stream Item Output Read the Common Feed Options section for more details. |
Browse to your Google+ page - e.g. https://plus.google.com/112592709425670873637
Your Google+ profile ID is the last set of numbers in the URL - in the example above, that would be - 112592709425670873637
Tumblr provides 1 feed option:
Parameter | Default Value | Alternative Values | Description |
---|---|---|---|
tumblr_id_1 | 1. Tumblr Username Enter a Tumblr username - e.g. username |
||
tumblr_thumb | 250 | 75, 100, 250, 400, 500, 1280 | Thumbnail Width 100 => Width: 100px 250 => Width: 250px 400 => Width: 400px 500 => Width: 500px 1280 => Width: 1280px |
tumblr_video | 250 | 250, 400, 500 | Video Width 400 => Width: 400px 500 => Width: 500px |
tumblr_embed | true | true, false | Embed video If true, all videos will be displayed inline - (Embed/Direct Link To Tumblr). |
tumblr_output | 'title,thumb,text,user,share,info' | title, thumb, text, user, share, info | Social Stream Item Output Read the Common Feed Options section for more details. |
To get a Tumblr username, browse to your Tumblr blog page - e.g. http://ghostphotographs.tumblr.com/
The Tumblr Username is the first word in the URL - in the example above, that would be - ghostphotographs
Delicious provides 1 feed option:
Parameter | Default Value | Alternative Values | Description |
---|---|---|---|
delicious_id_1 | Delicious username Enter a Delicious username to get your bookmarks - e.g. username |
||
delicious_output | 'title,text,user,share,info' | title, text, user, share, info, tags | Social Stream Item Output Read the Common Feed Options section for more details. |
Pinterest provides 2 different feed options:
Parameter | Default Value | Alternative Values | Description |
---|---|---|---|
pinterest_id_1 | 1. Pinterest username Enter a Pinterest username - e.g. username |
||
pinterest_id_2 | 2. Pinterest board To show a Pinterest board enter the username, then "/" followed by social stream name "username/board_name" - e.g. 2013TopPins/techology-trends |
||
pinterest_image_width | 237 | Image width 736 => Large - 736px |
|
pinterest_output | 'title,thumb,text,user,share,info' | title, thumb, text, user, share, info | Social Stream Item Output Read the Common Feed Options section for more details. |
To get a Pinterest username, browse to your Pinterest page - e.g. https://www.pinterest.com/2013TopPins/
The Pinterest Username is the last word in the URL - in the example above, that would be - 2013TopPins
To show a Pinterest board enter the username, then "/" followed by social stream name.
Browse to a Pinterest board - e.g. http://www.pinterest.com/2013TopPins/techology-trends/
In the example above, you would select - 2013TopPins/techology-trends
Flickr provides 2 different feed options:
Parameter | Default Value | Alternative Values | Description |
---|---|---|---|
flickr_id_1 | 1. Flickr User ID Enter a Flickr User ID - e.g. 46221135@N04 - You can obtain it from this website |
||
flickr_id_2 | 2. Flickr Group ID To use a flickr group enter the group ID - e.g. 34427465497@N01 - Use the same method mentioned above. |
||
flickr_thumb | 'm' | s, q, t, m, n, z, c, b | Thumbnail Size s => small square 75x75q => large square 150x150t => tiny, 100 on longest sidem => thumbnail, 240 on longest siden => small, 320 on longest sidez => medium 640, 640 on longest sidec => large 800, 800 on longest sideb => Extra large, 1024 on longest side |
flickr_output | 'title,thumb,text,user,share,info' | title, thumb, text, user, share, info, tags | Social Stream Item Output Read the Common Feed Options section for more details. |
46221135@N04
78842177@N00
Youtube provides 3 different feed options:
Parameter | Default Value | Alternative Values | Description |
---|---|---|---|
youtube_id_1 | 1. YouTube username Returns a list of videos uploaded by this user - Enter a YouTube username - e.g. username |
||
youtube_id_2 | 2. YouTube playlist Returns a collection of playlist items - Enter the unique ID of the playlist for which you want to retrieve playlist items - e.g. PLsBcifUwsKVXunQPoySupBM6QCcWliTKi |
||
youtube_id_3 | 3. YouTube search term Returns a collection of search results that match the search term query you specified - e.g. music |
||
youtube_id_4 | 4. YouTube channel ID Returns a list of videos uploaded by this channel - Enter a YouTube channel ID - e.g. UC1yP5nx6JNEBQI3ps2XFMpz |
||
youtube_thumb | 'medium' | default, medium, high, standard, maxres | Thumbnail Size default => Default - 120px × 90pxmedium => Medium - 320px × 180pxhigh => High - 480px × 360pxstandard => Standard - 640px × 480pxmaxres => Max - 1280px × 720px
|
youtube_output | 'title,thumb,text,user,share,info' | title, thumb, text, user, share, info | Social Stream Item Output Read the Common Feed Options section for more details. |
To get a Youtube username, browse to the desired Youtube profile page - e.g: https://www.youtube.com/user/envatopsd
The Youtube username is the last word in the URL - in the example above, that would be - envatopsd
To get a Youtube playlist ID, on the desired Youtube profile page click on the Playlists tab, select and browse to a playlist - e.g: https://www.youtube.com/watch?v=z4icxr8B7ik&list=PLsBcifUwsKVXunQPoySupBM6QCcWliTKi
The playlist ID is the last set of characters in the URL - in the example above, that would be - PLsBcifUwsKVXunQPoySupBM6QCcWliTKi
Vimeo provides 1 feed option:
Parameter | Default Value | Alternative Values | Description |
---|---|---|---|
vimeo_id_1 | 1. Vimeo username Enter a Vimeo username - e.g. abcdefg |
||
vimeo_thumb | 'medium' | small, medium, large | Thumbnail Size small => Small - 100x75medium => Medium - 200x150large => Large - 640
|
vimeo_output | 'title,thumb,text,user,share,info' | title, thumb, text, user, share, info | Social Stream Item Output Read the Common Feed Options section for more details. |
To get a Vimeo username, browse to the Vimeo profile - e.g: http://vimeo.com/bvanpeski
Your Vimeo username is the last name in the Vimeo profile URL - in the example above, that would be - bvanpeski
Stumbleupon provides 1 feed option:
Parameter | Default Value | Alternative Values | Description |
---|---|---|---|
stumbleupon_id_1 | Stumbleupon username Enter a Stumbleupon username - e.g. abcd |
||
stumbleupon_feeds | 'comments,likes' | comments, likes | Feed Data comments => Comments - User commentslikes => Likes - User likes
|
stumbleupon_output | 'title,thumb,text,user,share,info' | title, thumb, text, user, share, info | Social Stream Item Output Read the Common Feed Options section for more details. |
To get a Stumbleupon username, browse to the Stumbleupon profile - e.g: http://www.stumbleupon.com/stumbler/mashable
The Stumbleupon username is the last set of characters in the URL - in the example above, that would be - mashable
Deviantart provides 1 feed option:
Parameter | Default Value | Alternative Values | Description |
---|---|---|---|
deviantart_id_1 | 1. Deviantart username Enter a Deviantart username - e.g. abcd |
||
deviantart_output | 'title,thumb,text,user,share,info' | title, thumb, text, user, share, info | Social Stream Item Output Read the Common Feed Options section for more details. |
RSS Feeds have 1 feed option:
Parameter | Default Value | Alternative Values | Description |
---|---|---|---|
rss_id_1 | 1. RSS feed URL Enter the RSS feed URL - e.g. http://feeds.bbci.co.uk/news/world/europe/rss.xml |
||
rss_text | 0 | 0, 1 | Text Info 1 => Full Text |
rss_output | 'title,thumb,text,user,share,info' | title, thumb, text, user, tags, share, info | Social Stream Item Output Read the Common Feed Options section for more details. |
SoundCloud requires an API Client ID to provide the feed's data. Click here for more details.
SoundCloud provides 1 feed option:
Parameter | Default Value | Alternative Values | Description |
---|---|---|---|
soundcloud_id_1 | SoundCloud User Tracks The list of tracks of the user. Enter the SoundCloud Username - e.g. mayerhawthorne |
||
soundcloud_output | 'title,text,thumb,user,share,info,meta' | title, text, thumb, user, share, info, meta, tags | Social Stream Item Output Read the Common Feed Options section for more details. |
The list of tracks of the user. Enter the SoundCloud Username - e.g. mayerhawthorne
Browse to your SoundCloud page - e.g. https://soundcloud.com/axentmedia
Your SoundCloud Username is the last set of characters in the URL - in the example above, that would be - axentmedia
VK provides 1 feed option:
Parameter | Default Value | Alternative Values | Description |
---|---|---|---|
vk_id_1 | VK Wall Domain Returns a list of posts on a user wall or community wall. Enter the user or community short address - e.g. wphelpme or, ID of the user or community that owns the wall - e.g. id999999999 . |
||
vk_id_2 | VK Wall Owner ID Returns a list of posts on a user wall or community wall. Enter the ID of the user or community that owns the wall. By default, current user ID - e.g. 99999999 Use a negative value - to designate a community ID - e.g. -99999999 . |
||
vk_pagefeed | 'all' | owner, tagged, all | Filter to apply owner => Show only the posts by the wall ownertagged => Show the posts by someone elseall => Show both posts by the wall owner and others
|
vk_image_width | 604 | 75, 130, 604, 807, 1280, 2560 | Image width 130 => Small - 130px 604 => Medium - 604px 807 => Large - 807px 1280 => Larger - 1280px 2560 => X-Large - 2560px |
vk_output | 'thumb,text,stat,user,share,info' | thumb, text, stat, user, share, info | Social Stream Item Output Read the Common Feed Options section for more details. |
LinkedIn requires an API Key to display feed data. Click here for more details.
LinkedIn provides 1 feed option:
Parameter | Default Value | Alternative Values | Description |
---|---|---|---|
linkedin_id_1 | LinkedIn Company Page ID Returns a list of the company updates. Enter the LinkedIn Company Page ID - e.g. 10354180 . |
Vine provides 1 feed option:
Parameter | Default Value | Alternative Values | Description |
---|---|---|---|
vine_id_1 | Vine User Timeline Returns a list of user timeline updates. Enter the Vine username or ID - e.g. 974522892907909120 . |
Some networks require authentication to provide feed data. Open the social-stream/config.php
file and set the API Credentials for each network.
// API Credentials
$GLOBALS['api'] = array(
'facebook' => array(
'facebook_access_token' => 'Replace with a valid Facebook App Token'
// Use a long-lived App Token - e.g. <numeric part>|<alphanumeric part>.
),
'twitter' => array(
'twitter_api_key' => 'Replace with your Twitter API Key',
'twitter_api_secret' => 'Replace with your Twitter API Secret',
'twitter_access_token' => 'Replace with your Twitter OAuth Access Token',
'twitter_access_token_secret' => 'Replace with your Twitter OAuth Access Token Secret'
),
'google' => array(
'google_api_key' => 'Replace with your Google API KEY'
),
'instagram' => array(
'instagram_access_token' => 'Replace with your Instagram Access Token'
),
'flickr' => array(
'flickr_api_key' => 'Replace with your Flickr API Key'
),
'tumblr' => array(
'tumblr_api_key' => 'Replace with your Tumblr API Key'
),
'soundcloud' => array(
'soundcloud_client_id' => 'Replace with your SoundCloud Client ID'
),
'linkedin' => array(
'linkedin_access_token' => 'Replace with your LinkedIn Access Token'
),
'vimeo' => array(
'vimeo_access_token' => 'Replace with your Vimeo Access Token'
)
);
In this quick guide we are going to show you how to create an App in Facebook and get the App Token. This is required for all Facebook feeds.
facebook_access_token
in your Social Stream social-stream/config.php
file.Required For All Twitter Feeds.
To create a Twitter API credentials:After creating the Application, the Application Details page opens.
Copy the API Key, API Secret, Access Token and Access Token Secret values and paste into their respective fields in your Social Stream social-stream/config.php
file and the script should now have access to your Twitter feed data.
instagram_access_token
in your Social Stream social-stream/config.php
file or use it within instagram_id_1 array to get feed result from more than one Instagram account.If you want to use this method with any other endpoint rather than "Instagram Username" (users/self/media/recent), it requires your app to be approved by Instagram.
instagram_access_token
in your Social Stream social-stream/config.php
file or use it within instagram_id_1 array to get feed result from more than one Instagram account.social-stream/config.php
file and the script should now have access to your Google feed data.tumblr_api_key
in your Social Stream social-stream/config.php
file.flickr_api_key
in your Social Stream social-stream/config.php
file.soundcloud_client_id
in your Social Stream social-stream/config.php
file.linkedin_access_token
in your Social Stream social-stream/config.php
file.vimeo_access_token
in your Social Stream social-stream/config.php
file.To setup Ads, you should define your Ad items in $GLOBALS['ads']
array.
The following example is showing everything as well (You can find the complete example in wall-demo-1.php file located in your downloaded package):
The X
in $GLOBALS['ads'][X] variable defines the ID of the social stream you want to add the Ads to.
// Setup Ads
$GLOBALS['ads'][1] = array(
array(
'ad_position' => 3,
'ad_type' => 'image',
'ad_height' => null,
'ad_border_size' => 1,
'ad_border_color' => null,
'ad_background_color' => null,
'ad_text_align' => 'center',
'ad_grid_size' => 'solo',
'ad_text' => null,
'ad_custom_code' => null,
'ad_link_target' => 'blank',
'ad_link' => 'http://axentmedia.com/',
'ad_image' => 'http://axentmedia.com/wp-content/uploads/2016/10/ad-here-7.png',
),
array(
'ad_position' => 9,
'ad_type' => 'image',
'ad_border_size' => 1,
'ad_text_align' => 'center',
'ad_grid_size' => 'twofold',
'ad_link_target' => 'blank',
'ad_link' => 'http://axentmedia.com/',
'ad_image' => 'http://axentmedia.com/wp-content/uploads/2016/10/ad-here-3.jpg',
)
// And continue with more Ad items...
);
Parameter | Default Value | Alternative Values | Description |
---|---|---|---|
ad_position | 0 - ∞ | Ad Block Position Define the numeric position of where you want to see the ad on your Social Stream. |
|
ad_type | text, code, image | Type of Ad Select the type of ad you would like to add as an advertisement block on your Social Stream. |
|
ad_height | Block Height Define a height for the ad block - Leave empty for auto height. |
||
ad_border_size | Block Border Size Define a border size for the ad block. |
||
ad_border_color | Block Border Color Select a border color for the ad block if you require in RGB hex format - e.g. #d9d9d9 . |
||
ad_background_color | Block Background Color Select a background color for the ad block if you require in RGB hex format - e.g. #d9d9d9 . |
||
ad_grid_size | solo | solo, twofold, threefold | Ad Grid Size Defines the number of columns to fill for this ad block - Works for wall layout only! |
ad_text | Ad Text Any text interted in this text area will automatically be added into the ad block. |
||
ad_custom_code | Custom Code Any custom HTML/JS code included in this text area will automatically be inserted into the ad block. |
||
ad_image | Banner Image Enter the direct url of the image file or click on the relevant "Select Image" button and an "Upload Image" window should now appear. |
||
ad_link | Banner Link Enter the link you would like to be redirected to after clicking the banner image. |
||
ad_link_target | self | blank, self | Link Target Select the target for the above banner link. |
You can define custom filtering buttons to filter your wall items using different search terms. Here, you can find a working example of custom filtering wall.
The following example code is also showing everything as well (You can find the complete example in wall-custom-filtering.php file located in your downloaded package):
echo social_stream(
array(
'id' => '1',
'type' => 'wall',
'network' => array(
'facebook' => array(
'facebook_id_1' => array(
'359816710874516',
'18010778998'
),
'facebook_id_2' => array(
'874974472678892'
),
'facebook_pagefeed' => 'posts'
),
'twitter' => array(
'twitter_id_3' => array(
'illustration',
'fashion',
'maserati'
),
'twitter_images' => 'small',
'twitter_feeds' => ''
),
'instagram' => array(
'instagram_id_2' => array(
'illustration',
'fashion',
'maserati'
)
)
),
'theme' => 'sb-modern-light',
'itemwidth' => 250,
'results' => 30,
'iframe' => 'media',
'breakpoints' => array('4', '4', '3', '3', '2', '1', '1'),
'filter_search' => true,
'filters_order' => 'linkedin,facebook,twitter,instagram,google,pinterest',
'display_ads' => true,
'debuglog' => 1,
'cache' => 360,
'add_files' => true,
'fixWidth' => 'block',
'filtering_tabs' => array(
array(
'search_term' => 'fashion',
'tab_title' => 'Fashion'
),
array(
'search_term' => 'illustration',
'tab_title' => 'Illustration'
),
array(
'search_term' => 'maserati',
'tab_title' => 'Maserati'
)
)
)
);
Parameter | Example | Description |
---|---|---|
search_term | fashion | Search Term Define a search term for the filter button. |
tab_title | Fashion | Filter button title Define a title (name) for the filter button. |
filter_icon | SB_PATH . 'public/img/fashion-icon.png' | Filter button icon Define an icon (image) for the filter button. |
To create/customize themes open the social-stream/config.php
file and set your appropriate changes in $GLOBALS['themes']
array.
To create a Theme, add a new unique item into $GLOBALS['themes']
array.
// Themes
$GLOBALS['themes'] = array(
// Modern Light
'sb-modern-light' => array( // <-- CSS Class Name
'layout' => 'modern',
'font_size' => '11',
'social_colors' => array(
'facebook' => '#305790',
'twitter' => '#06d0fe',
'google' => '#c04d2e',
'tumblr' => '#2E4E65',
'delicious' => '#2d6eae',
'pinterest' => '#cb1218',
'flickr' => '#ff0185',
'instagram' => '#295477',
'youtube' => '#b80000',
'vimeo' => '#00a0dc',
'stumbleupon' => '#ec4415',
'deviantart' => '#495d51',
'rss' => '#d78b2d',
'soundcloud' => '#4c75a3',
'vk' => '#ff3300',
'linkedin' => '#1884BC',
'vine' => '#39a97b'
),
'type_icons' => '',
'custom_css' => '',
'wall' => array(
'background_color' => '',
'border_color' => '',
'border_size' => 0,
'background_image' => '',
'font_color' => '#000000',
'link_color' => '#305790',
'item_background_color' => '#ffffff',
'item_border_color' => '#e5e5e5',
'item_border_size' => 1
),
'timeline' => array(
'background_color' => '',
'border_color' => '',
'border_size' => 0,
'background_image' => '',
'font_color' => '#000000',
'link_color' => '#305790',
'item_background_color' => '#ffffff',
'item_border_color' => '#e5e5e5',
'item_border_size' => 1
),
'feed' => Array(
'title_background_color' => '#dd3333',
'title_color' => '#ffffff',
'background_color' => '#f2f2f2',
'border_color' => '#e5e5e5',
'border_size' => 1,
'background_image' => '',
'font_color' => '#000000',
'link_color' => '#305790',
'item_background_color' => '#ffffff',
'item_border_color' => '#e2e2e2',
'item_border_size' => 1
),
'feed_sticky' => Array(
'title_background_color' => '#dd3333',
'title_color' => '#FFFFFF',
'opener_image' => '',
'background_color' => '#f2f2f2',
'border_color' => '#d6d6d6',
'border_size' => 1,
'background_image' => '',
'font_color' => '#000000',
'link_color' => '#305790',
'item_background_color' => '#ffffff',
'item_border_color' => '#e2e2e2',
'item_border_size' => 1
),
'feed_carousel' => Array(
'title_background_color' => '#dd3333',
'title_color' => '#ffffff',
'background_color' => '#f2f2f2',
'border_color' => '#e5e5e5',
'border_size' => 1,
'background_image' => '',
'font_color' => '#000000',
'link_color' => '#305790',
'item_background_color' => '#ffffff',
'item_border_color' => '#e2e2e2',
'item_border_size' => 1
)
)
// And continue with more theme items...
);
This is the name for the theme CSS class selector (without dot).
You will also use this name as theme parameter in social_stream()
function to point to your desired theme.
Parameter | Default Value | Alternative Values | Description |
---|---|---|---|
layout | default, flat, modern, modern2, metro | Social Stream Layout The social stream layout is the main displaying structure of the output feed items. We have created 4 different built-in layouts for the social stream. You can create your own layout and put in the ../social-stream-layouts/ folder next to the ./social-stream/ folder, to use here. For more information on how to create your own custom layout click here. |
|
font_size | 0 - ∞ | Font Size In order to set a font size (in px) for the Social Stream. This is the base font size for all type of social streams. |
|
social_colors | Social Networks Color You can change the background colors used for each social network. Enter network colors as an array in, RGB hex format - e.g. array('facebook' => '#305790', 'twitter' => '#06d0fe', ...) . These colors apply to network icons, block footers or anywhere defined in layout files. |
||
social_icons | Social Networks Icons You can change the icon used for each social network. To change the network icons, enter the direct URL of the icon files as an array - e.g. array('http://icon1', 'http://icon2', ...) . Some layouts do not use image icons. |
||
type_icons | Post Type Icons You can change the icon used for each post type. To change the type icons, enter the direct URL of the icon files as an array - e.g. array('http://icon1', 'http://icon2', ...) . |
||
custom_css | Custom CSS Custom CSS for styling the Social Stream can be entered into this text field. Any CSS rules included here, will automatically be inserted into the page. As an example you can write your CSS code something like this: .sboard.<class-name> .sb-item { font-family: Arial, sans-serif; } Replace <class-name> with the "CSS Class Name" in the current theme. |
Each type of social stream (Wall, Timeline, Feed, Sticky Feed or Carousel Feed) has it's dedicated options in a separate tab.
Parameter | Default Value | Alternative Values | Description |
---|---|---|---|
background_color | Body Background Color This color applies to your Social Stream background. Select the background color in RGB hex format - e.g. #f3f3f3 . |
||
border_color | Body Border Color Select the border color of the Social Stream in RGB hex format - e.g. #d9d9d9 . |
||
border_size | Body Border Size In order to set a border size (in px) for the Social Stream. |
||
background_image | Body Background Image In order to set a background image for the Social Stream. |
||
font_color | Font Color Select the font color for the feed item in RGB hex format - e.g. #000000 . |
||
link_color | Link Color The font color for the links in feed item. Add color in RGB hex format - e.g. #305790 . |
||
item_background_color | Item Background Color Select the background color for the feed item in RGB hex format. |
||
item_border_color | Item Border Color Select the border color for the feed item in RGB hex format. |
||
item_border_size | Item Border Size In order to set a border size (in px) for the feed item. - e.g. 1 |
social-stream/public/css/styles.css
on your website using an FTP client and add your own css at the end of the file.../social-stream-layouts/
directory next to the ./social-stream/
folder and create a new .php file with your own layout name - e.g. mylayout.php
social-stream/config.php
file.Sometimes you may wanted to pin/stick an item on top of your created Social Stream or remove an item from the Social Stream. To do this, add the list of social update links as an array into the "pins" (for pinning) or "remove" (for removing) parameters in the social_stream() function.
Look at the following example to find out more:
<?php
include( './social-stream/social-stream.php' ); // Path to PHP Social Stream main file
echo social_stream(
array(
'id' => '1',
'type' => 'wall',
'network' => array(
'facebook' => array(
'facebook_id_1' => array(
'624290390999239'
)
),
'twitter' => array(
'twitter_id_3' => array(
'socialmedia'
)
),
'soundcloud' => array(
'soundcloud_id_1' => array(
'mayerhawthorne'
)
),
'vk' => array(
'vk_id_1' => array(
'worldoftanks'
)
)
),
'theme' => 'sb-modern-light',
'order' => 'random',
// To pin/stick an item on top of your Social Stream
'pins' => array(
'https://www.facebook.com/envatomarket/photos/a.676459932448951.1073741828.624290390999239/853675044727438/?type=1',
'http://soundcloud.com/mayerhawthorne/the-stars-are-ours-disco-version',
'http://vk.com/wall-9159189_6258236'
),
// To remove an item from the Social Stream
'remove' => array(
'http://vk.com/wall-9159189_6262557',
'https://twitter.com/nicohof1/status/618380737377492992'
)
)
);
?>
Each item on social stream has a date/time in its footer area that is linked to the original post. You can copy that link to use.
To translate Social Stream to your local language:
social-stream/config.php
file in an editor.SB_LOCALE
variable to your desired language that you want to create a translation for - e.g. define( 'SB_LOCALE', 'nl_NL' );
for Nederlands.social-stream/language/
folder - e.g. social-stream-nl_NL.php
and open in an editor.social-stream-xx_XX.php
file from your computer into social-stream/language/
folder on your website using an FTP client.<?php
$_['tags'] = "Tags";
$_['posted'] = "Gepost";
$_['show_all'] = "Toon Alles";
$_['comments'] = "reacties";
$_['likes'] = "ik-leuks";
$_['load_more'] = "Laad meer";
$_['a_long_while_ago'] = "een lange tijd geleden";
$_['over_2_years_ago'] = "Meer dan 2 jaar";
$_['over_a_year_ago'] = "meer dan een jaar geleden";
$_['about_a_year_ago'] = "een jaar geleden";
$_['d_months_ago'] = "%d maanden geleden";
$_['last_month'] = "vorige maand";
$_['3_weeks_ago'] = "3 weken geleden";
$_['2_weeks_ago'] = "2 weken geleden";
$_['last_week'] = "vorige week";
$_['d_days_ago'] = "%d dagen geleden";
$_['yesterday'] = "gisteren";
$_['d_hours_ago'] = "%d uur geleden";
$_['an_hour_ago'] = "een uur geleden";
$_['d_minutes_ago'] = "%d minuten geleden";
$_['just_now'] = "zojuist";
?>
This message is usually caused for one of the following reasons:
After fixing the problem, try cleaning the cache files in the social-stream/cache/
directory.
If you see the social_stream() function appears in your website as a text instead of a Social Stream, it is caused for one of the following reasons:
social-stream/cache/
directory.There could be one the following reasons that your Facebook feed may not work:
Unfortunately, this is Twitter API limitations for hashtags or any search that is made via its API platform and we can't change this rule. The Search API is not complete index of all Tweets, but instead an index of recent Tweets.
Please check Twitter Search API Documentation for your reference.
Without creating apps and adding API tokens and keys, your website will not be able to connect to the Social Networking servers. The token authentication makes a secure channel via Social Network server and your website to get the permission to access your social profile and fetch your social feed.
You need to purchase one license for each site you want to use PHP Social Stream on.
1 site = 1 license, 2 sites = 2 licenses, 3 sites = 3 licenses and so on.
It doesn’t matter if they are all in use by the same company, on the same server, by the same developer, etc. The license terms are single use – one license per site.
Currently, the only option is to purchase an individual Regular License for each site on which PHP Social Stream will be used.
The CodeCanyon standard (Regular/Extended) licenses both are only for individual (single) usage. The only difference is about to charge or not to charge the end customer.
We can not also provide you with a developer/multi-use license directly as we have an exclusivity agreement with CodeCanyon that means, we can only distribute our products through them.
At this time, for every WordPress site that you have PHP Social Stream activated on, you need to purchase an individual Regular or Extended License. 1 site = 1 license, 2 sites = 2 licenses, 3 sites = 3 licenses, etc.
For more information please read this article: http://codecanyon.net/licenses/faq
Below is an example of a PDF License certificate and purchase code.
PHP Social Stream Script - Created By Axent Media - CodeCanyon license.
Server-Side Scripting
OAuth library - by Andy Smith - MIT license.
OAuth for Twitter's REST API - Created by Abraham Williams.
SimpleCache - Created by Gilbert Pellegrom - MIT license.
Client-Side Scripting
jQuery - Released under the terms of the MIT license.
Isotope - Copyright 2016 Metafizzy - Commercial license included.
Timeline Drop - by kickdrop.me.
JQuery Advanced News Ticker - Created by Valentin Ledrapier - GNU GENERAL PUBLIC LICENSE.
Font Awesome - by @davegandy - Licensed under MIT
Colorbox - by Jack Moore - Licensed under MIT
lightslider - by Sachin N - Licensed MIT
Lazy Load - by Mika Tuupola - MIT license.
Special scroll events for jQuery - by James Padolsey.
jQuery Expander - by Karl Swedberg - Licensed MIT.