Activity attachments


A key part of sharing posts with other users includes sharing photos, video and audio. WP Symposium Pro supports the attachment of images, the inclusion of YouTube URLs and SoundCloud audio. You can select which you want to permit via WPS Pro->Setup:



If you permit image attachments, after activation, above the initial post area and below any comment areas, there is a new item of text “Attach an image”. A user simply clicks on this to select one, or more, images to attach to their post. If their browser is old, they may only be able to attach one image at a time.


The images attached are shown as “thumbnails”, and if clicked on will “zoom” to show the full image. Clicking on the image again, or pressing Escape, will hide the full image. An image can be deleted by the post author, or the site administrator, by clicking on the trash can icon.

YouTube videos

To show a YouTube video below your post simply copy and paste the YouTube URL when viewing the video on YouTube into your post and it will be detected, and the video displayed below the post.

The video is responsive, that is, will re-size when viewed on mobile devices, tablets, etc.


In the same way as with YouTube videos, simply visit the SoundCloud page and copy the URL.

When included in your activity post it will be detected and displayed using what SoundCloud refers to as the web widget.

You will need to create and enter a Souncloud Client ID. Follow the link on WPS Pro->Setup->SoundCloud.

Website link previews

You can choose whether any links to websites are automatically shown below the activity post, with (optionally) an image from the page linked to, the page title and the page description.


Title and description are based on the <title> tag and the <meta> “description” field. If no description field exists, the URL of the page is shown instead.

Not all websites will permit remote interrogation, sometimes this means that no image will be retrieved, and sometimes even the title and description are unavailable.

If there are any problems when an activity stream is being viewed, for administrators only, the problem is displayed at the top of the screen. It is only shown the first time if “Dynamic Previews (no caching)” is disabled, which is likely for performance reasons (see options below). If dynamic previews is enabled the error will be displayed every page load. For example:



Provided in the Extensions Plugin.


You can use the global shortcode settings via WPS Pro->Shortcodes in the admin dashboard, or add them to the shortcode as options.


Website link previews

The following (which shows default values and an example of using the shortcode option) can be set as options to the shortcode in your WordPress page, post or widget.

Website link preview options are found under WPS Pro->Shortcodes->Activity->[wps-activity].

The way that web link previews works is by retrieving the source of the linked web page and scanning for the page title and description.

Based on the page source, your server then scans and processes the images one at a time to determine if it is to be shown, based on max_previews, ignore_images, min_width and max_width, stopping when a suitable one is found.

The more images that have to be scanned and processed, the slower the browser will load the profile page, as it is waiting for your server to finish analysing the page and images.

With dynamic_previews set to 0 (false) this is a one-off operation when the activity post is loaded, by any user. They are then cached, so they image and information is only loaded once.

If multiple links are included in the activity post, only the last link is converted into a preview if caching is on (ie. dynamic_previews set to false).

The activity post owner or site administrator can remove the image (if considered not suitable) by clicking on the trash can that appears top of the image. The entire preview can be removed by clicking on the trash can top-right of the preview box.

If you set dynamic_previews to 1 (true) this extension does add a load on to your server, and the more images you show, or conditions you add, page load time will be increased.

The chances of the image and meta information changing during the time the activity post remains relevant is slim, and so it is not recommended to set dynamic_previews to 1 (true).

If you choose to have dynamic previews, you can improve performance in two ways. The first is to improve your server’s power and internet connection speed! The second is by setting the shortcode paramters as follows:

max_previews 1 (only show first preview link)
min_width  0 (always show first image on page)
ignore_images '' (so nothing to process or images to skip)

Default: false
By default, once a preview has been fetched, it is cached to avoid slow profile page loading time. Although not recommended, you can force every URL to be dynamically fetched by setting to 1 (true) but it will significantly impact on page load time. Consider a very low value for max_previews if dynamic_ previews=1. Please read about max_previews too…

Default: 10
Sets how many web link previews are shown, which can be higher if dynamic_previews is false (as they are all cached after the first time the image and information is retrieved). If you have dynamic_previews set to 1 (true), your server has to fetch the information and the image every time, for every link. This will add load to your server and significantly increase the time it takes for the activity to load. Therefore, set max_ previews to a low number (probably 1) if dynamic_previews is set to 1 (true). Setting dynamic_previews to 1 (true) is not recommended!

Default: adserver,ads,affiliate
A list of comma seperated words that, if in the URL of the image, will cause the image to be ignored, for example the following will cause any image with the words adserver,logo or example to be ignored: “adserver,logo,example”

Default: ”
A list of comma seperated words that, if in the URL of the link, will cause the link to be ignored. For example, any link with google,microsoft or example will be ignored: “google,microsoft,example”

Default: 100
Size of the preview image, set to 0 to disable, which will improve performance (as not searched for/fetched from the URL).

Default: true
Set to 0 (false) to not show the preview if the remove site cannot be connected to.

The text shown as the description if the site cannot be connected to. Can be set to “” to not show a message.

The URL of an image to use, if no image can be retrieved from the site (no image or due to ignore_images list).

Default: 200
Minimum width of image to show, set to 0 to show first image on page. As each image is processed, for better performance set to 0.

Default: 1000
Maximum width of image to show, or 0 to ignore. Can be used to avoid sending large images to the browser for better performance.

Dynamic Previews (dynamic_previews=”0″)
Max Previews (max_previews=”10″)
Preview image size (url_preview_image=”100″)
Enable image fail (url_preview_fail=”1″)
Minimum width used (min_width=”200″)
Maximum width used (max_width=”0″)
Fail text (fail_text=”Unable to connect to site”)
Fail image (fail_image=”http://localhost/wp-content/plugins/wp-symposium-pro-extensions/wp-symposium-pro-activity-url-preview/broken.png”)
Images to ignore (ignore_images=”adserver,ads,affiliate”)
Url words to ignore (ignore_links=””)