Cision Block

Cision Block

Wordpress plugin

Install on Wordpress

App Details

This plugin is developed by Cyclonecode and can be used to load and expose press releases made by Cision.

To start pulling feed items from cision you first need to add the unique identifier for you json feed at the configuration page for the plugin.
You can also change how many feed items to pull, type of feed items, enable pagination, configure caching and much more.

If you have questions or perhaps some idea on things that should be added you can also try slack.

Pro Version

There is a PRO version of this plugin, which includes extended features. For instance:

★ Support to fetch entire feed and not only the last 50 entries.
★ Custom post types. Creates a post for each item in WordPress. This means that all news have standard WordPress links.
★ Manually created posts can be added to the feed.
★ Custom taxonomies for categories and tags fetched from Cision.
★ Use standard article template from your active theme.
★ Support to create, update and delete posts based on PUSH events sent from Cision.
★ Support to create, update and delete posts during CRON at configurable intervals.
★ Calendar module.
★ Cron module.
★ Insider module.
★ Link Back module.
★ Media module.
★ Share Graph module.
★ ShareHolder module.
★ Share Calculator module.
★ Subscription module.
★ Ticker module.
★ Translation module.
★ Use normal or ajax based load more button for pagination.
★ Annual free support and quicker response times.
★ Discount for multisite licenses.

I usually have an initial meeting where I talk about the plugin, explain the different features and answer any questions.

A demo site showing some of the modules can be found here.

To get more information about the Pro version, email me at [email protected] or give me a call at +(46)-767013987.

Addons

Even if you are not using the premium version of the plugin there is still possible to install addons for extended functionality.

Here is a list of the available addons:

  • Calendar
  • Insider
  • Media
  • Share Graph
  • ShareHolder
  • Share Calculator
  • Subscription
  • Ticker

Looking for help

I am currently in the search for someone who would like to help me with something of the following:

  • Create a dashboard icon which can be used in the admin menu.
  • Create a banner that would be displayed on the plugins homepage at wordpress.org.
  • Design a nicer and more intuitive admin interface.
  • Create a solid looking icon that can be used on multiple places.

If you would like to help with anything of the above, please do not hesitate and contact me either on slack or by email.

Developers

I am looking for developers that would be interested in contributing to either the free or premium version of the plugin.

Would be great just to get some ideas and input from others who have some experience in WordPress plugin development.

At this point I am pretty much on my own, which will sometimes result in me just thinking around some issues in my own way; here I think it would be awesome to have others to talk to and collaborate.

If you think this sounds interesting, please drop me an email or ping me on Slack.

Widget

You can display a feed in any sidebar by adding and configure a widget.

Shortcode

The shortcode [cision-block] can either be used by adding it to the content field of any post or by using the do_shortcode function in one of your templates.

Shortcode attributes:

  • id
    Assign a specific name for a block.

  • source_uid
    A unique feed identifier.

  • language
    The language code for each feed item. For example ‘en’ for english.

  • date_format
    The date format to use.

  • readmore
    The readmore button text.

  • count
    The maximum number of items to include in the feed.

  • view
    This states what kind of items to include:
    1 – include both regulatory and non-regulatory items.
    2 – include only regulatory items.
    3 – include only non-regulatory items.

  • start
    Sets the start date for the feed items. The format to use is 2016-12-31.

  • end
    Sets the end date for the feed items. The format to use is 2016-12-31.

  • mark_regulatory
    Emphasis if a release if regulatory or non-regulatory.

  • regulatory_text
    Text to display for regulatory items.

  • non_regulatory_text
    Text to display for non-regulatory items.

  • show_filters
    Enable filtering of feed items.

  • filter_all_text
    Button text for ‘all’ filter.

  • filter_regulatory_text
    Button text for ‘regulatory’ filter.

  • filter_non_regulatory_text
    Button text for ‘non-regulatory’ filter.

  • items_per_page
    Sets the number of feed items to display on each page.

  • tags
    Only press releases with the specified tag will be included. Multiple tags can be separated with a comma.

  • categories
    Only press releases that has one or more of the specified categories will be included. Multiple categories can be separated with a comma.

  • types
    Only press releases of the specified types will be included.

  • image_style
    The image style to use:

    • DownloadUrl
    • UrlTo100x100ArResized
    • UrlTo200x200ArResized
    • UrlTo400x400ArResized
    • UrlTo800x800ArResized
    • UrlTo100x100Thumbnail
    • UrlTo200x200Thumbnail
  • show_excerpt
    Display excerpt for each feed item.

  • template
    Template file to use. If no template is set in settings and this parameter is not set then cision-block.php in either the active
    theme or in the plugin will be used as a default.
    You can either use the name of the template as given in the template header e.g ‘Foo’ or the actual filename e.g foo.php.

  • flush
    Clears the cache for the block.

Here is an example using all of the above attributes:

[cision-block id=example_block source_uid=A275C0BF733048FFAE9126ACA64DD08F language=sv date_format=m-d-Y readmore="Read more" show_excerpt=0 view=1 count=6 items_per_page=2 tags="cision,company" categories="New Year,Summer camp" types="PRM, RDV" start=2016-01-12 end=2019-06-12 image_style=UrlTo400x400ArResized mark_regulatory=1 regulatory_text=Regulatory non_regulatory_text=*none* show_filters=1 filter_all_text=*none* filter_regulatory_text=Regulatory filter_non_regulatory_text=Non-regulatory template=foo.php flush=true] 

Notice that all shortcode attributes are optional and that they must be on a single line.
Default values is taken from the plugins settings page.

Here is a complete list of the different kind of pressreleases:

  • KMK – Annual Financial statement
  • RDV – Annual Report
  • PRM – Company Announcement
  • RPT – Interim Report
  • INB – Invitation
  • NBR – Newsletter

More than one block in a page

To use more than one block in a single page you will need to set a unique id for each block or else they will both share the same cache entry.

Filter and marking feed items

On the ‘Filters’ tab you can enable filtering on you feed and add a text for the different kind of filters or use the default ones.
If for some reason you would like to hide a specific filter button you can enter the special value *none* in the corresponding text field.

You can add a text for each feed item stating if it is regulatory or not by checking the ‘Mark regulatory’ checkbox in the settings page.
If you wish to hide the text for regulatory or non-regulatory releases you can use the special value *none* in the corresponding text field.

Template

The template used to render the feed is cision-block/templates/cision-block.php, you can override
this template by copying it to either the root or under a templates folder in your theme.

You can also select a specific template which will be used to render the feed under the plugins settings page.
To create a new template, you can follow the steps as described in this link: Page Templates:

For instance adding a file with the following header comment would create a new ‘Foo’ template:

<?php /** * Template name: Foo * Template Post Type: cision-block-post * * Template used to display a feed from Cision. **/ ?> 

Display single press releases in WordPress

Since version 2.0.0 it is possible to fetch and display press releases directly from within WordPress.
The template used in this case is cision-block/templates/cision-block-post.php, you can override
this template by copying it to either the root or under a templates folder in your theme.

The $CisionItem feed object that is available in the template contains all raw data fetched from Cision.
Under the Resources section there is a link that explains all the different fields that is available.
For example if you use the $CisionItem->HtmlBody to display content from the feed item you might have to add custom
css since this contains pre formated html which may include inline css and so on.

Fields

By default only the following fields are collected for each feed item:

  • Title
  • Intro
  • Body
  • PublishDate
  • CisionWireUrl
  • IsRegulatory
  • Images[0]
    • DownloadUrl
    • Description

Filters

Add more fields to each feed item:

add_filter('cision_map_source_item', function($item, $data, $block_id) { $item['Header'] = sanitize_text_field($data->Header); $item['LogoUrl'] = esc_url_raw($data->LogoUrl); $item['SocialMediaPitch'] = sanitize_text_field($data->SocialMediaPitch); return $item; }, 10, 3); 

Customize the sorting of the feed items:

add_filter('cision_block_sort', function($items, $block_id) { usort($items, function($a, $b) { return $a->PublishDate > $b->PublishDate; }); return $items; }, 10, 2); 

Add custom attributes to the pager:

add_filter('cision_block_pager_attributes', function(array $attributes, $block_id) { return array_merge( $attributes, array( 'class' => 'custom-class', 'id' => 'custom-id', ) ); }, 10, 2); 

Set a custom class for active pager item:

add_filter('cision_block_pager_active_class', function($class, $block_id) { return 'custom-class'; }, 10, 2); 

To add attributes to the section wrapper in the template:

add_filter('cision_block_wrapper_attributes', function(array $attributes, $block_id) { return array( 'class' => array( 'custom-class', ), ); }, 10, 2); 

To add attributes to the article wrapper in the template:

add_filter('cision_block_media_attributes', function(array $attributes, $block_id) { return array( 'class' => array( 'custom-class', ), ); }, 10, 2); 

Add a prefix that will be displayed at the start of the wrapper:

add_filter('cision_block_prefix', function($prefix, $block_id) { return '<h1>Prefix</h1>'; }, 10, 2); 

Add a suffix that will be displayed at the end of the wrapper:

add_filter('cision_block_suffix', function($suffix, $block_id) { return '<h1>Suffix</h1>'; }, 10, 2); 

Resources

A complete list of fields can be found at: https://websolutions.ne.cision.com/documents/P2_Feed.pdf

The following Feed identifier can be used for testing: A275C0BF733048FFAE9126ACA64DD08F

Improvements

If you have any ideas for improvements, don’t hesitate to email me at [email protected] or send me a message on slack.

Support

If you run into any trouble, don’t hesitate to add a new topic under the support section:
https://wordpress.org/support/plugin/cision-block

You can also try contacting me on slack.

Pricing

Starting from $0 per month.

Check Out the Trust Badges Widget

By Common Ninja

Trust BadgesTry For Free!

App Info

Rating

Reviewers

14 reviews

Tags

cision
feed
press
stock

Developed By

cyclonecode

Quick & Easy

Find the Best Wordpress plugins for you

Common Ninja has a large selection of powerful Wordpress plugins that are easy to use, fully customizable, mobile-friendly and rich with features — so be sure to check them out!

Testimonial

Testimonial plugins for Wordpress

Contact Form

Contact Form plugins for Wordpress

Maps

Maps plugins for Wordpress

Translation

Translation plugins for Wordpress

Chat

Chat plugins for Wordpress

Slider

Slider plugins for Wordpress

Reviews

Reviews plugins for Wordpress

Contact

Contact plugins for Wordpress

Galleries

Galleries plugins for Wordpress

SEO

SEO plugins for Wordpress

Forms

Forms plugins for Wordpress

Comments

Comments plugins for Wordpress

Backup

Backup plugins for Wordpress

Privacy

Privacy plugins for Wordpress

Optimize

Optimize plugins for Wordpress

Tabs

Tabs plugins for Wordpress

Social Sharing

Social Sharing plugins for Wordpress

Events Calendar

Events Calendar plugins for Wordpress

Comments

Comments plugins for Wordpress

Social Feeds

Social Feeds plugins for Wordpress

Social Sharing

Social Sharing plugins for Wordpress

Portfolio

Portfolio plugins for Wordpress

Video Player

Video Player plugins for Wordpress

popup

popup plugins for Wordpress

SiteMap

SiteMap plugins for Wordpress

Payment

Payment plugins for Wordpress

Coming Soon

Coming Soon plugins for Wordpress

Inventory

Inventory plugins for Wordpress

Testimonials

Testimonials plugins for Wordpress

Portfolio

Portfolio plugins for Wordpress

Membership

Membership plugins for Wordpress

Forms

Forms plugins for Wordpress

Analytics

Analytics plugins for Wordpress

Events Calendar

Events Calendar plugins for Wordpress

Sliders

Sliders plugins for Wordpress

Analytics

Analytics plugins for Wordpress

Reviews

Reviews plugins for Wordpress

Security

Security plugins for Wordpress

Ads

Ads plugins for Wordpress

Music Player

Music Player plugins for Wordpress

Countdown

Countdown plugins for Wordpress

Email Marketing

Email Marketing plugins for Wordpress

Membership

Membership plugins for Wordpress

Ecommerce

Ecommerce plugins for Wordpress

Customer Support

Customer Support plugins for Wordpress

Video Player

Video Player plugins for Wordpress

Tabs

Tabs plugins for Wordpress

Social Feeds

Social Feeds plugins for Wordpress

More plugins

plugins You Might Like

Discover Apps By Platform

Discover the best apps for your website

WordPress
Wix
Shopify
Weebly
Webflow
Joomla
PrestaShop
Shift4Shop
WebsiteX5
MODX
Opencart
NopCommerce

Common Ninja Search Engine

The Common Ninja Search Engine platform helps website builders find the best site widgets, apps, plugins, tools, add-ons, and extensions! Compatible with all major website building platforms - big or small - and updated regularly, our Search Engine tool provides you with the business tools your site needs!

Multiple platforms