[{"name":"Cision Block","slug":"cision-block","version":"4.2.0","author":"Cyclonecode","author_profile":"https://profiles.wordpress.org/cyclonecode/","requires":"5.3","tested":"6.6.2","requires_php":"7.4","requires_plugins":[],"rating":100,"ratings":{"1":0,"2":0,"3":0,"4":0,"5":14},"num_ratings":14,"support_threads":0,"support_threads_resolved":0,"downloaded":9685,"last_updated":"2024-08-15 10:23am GMT","added":"2017-07-20","homepage":"","sections":{"description":"

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.
\nYou 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.
\n★ Custom post types. Creates a post for each item in WordPress. This means that all news have standard WordPress links.
\n★ Manually created posts can be added to the feed.
\n★ Custom taxonomies for categories and tags fetched from Cision.
\n★ Use standard article template from your active theme.
\n★ Support to create, update and delete posts based on PUSH events sent from Cision.
\n★ Support to create, update and delete posts during CRON at configurable intervals.
\n★ Calendar module.
\n★ Cron module.
\n★ Insider module.
\n★ Link Back module.
\n★ Media module.
\n★ Ownership module.
\n★ Share Graph module.
\n★ Share Calculator module.
\n★ Subscription module.
\n★ Ticker module.
\n★ Translation module.
\n★ Use normal or ajax based load more button for pagination.
\n★ Annual free support and quicker response times.
\n★ 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 cisionblock@gmail.com or give me a call at +(46)-767013987.

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:

\n
id
\nAssign a specific name for a block.
\n
\n
source_uid
\nA unique feed identifier.
\n
\n
language
\nThe language code for each feed item. For example ‘en’ for english.
\n
\n
date_format
\nThe date format to use.
\n
\n
readmore
\nThe readmore button text.
\n
\n
count
\nThe maximum number of items to include in the feed.
\n
\n
view
\nThis states what kind of items to include:
\n1 – include both regulatory and non-regulatory items.
\n2 – include only regulatory items.
\n3 – include only non-regulatory items.
\n
\n
start
\nSets the start date for the feed items. The format to use is 2016-12-31.
\n
\n
end
\nSets the end date for the feed items. The format to use is 2016-12-31.
\n
\n
show_filters
\nEnable filtering of feed items.
\n
\n
filter_all_text
\nButton text for ‘all’ filter.
\n
\n
filter_regulatory_text
\nButton text for ‘regulatory’ filter.
\n
\n
filter_non_regulatory_text
\nButton text for ‘non-regulatory’ filter.
\n
\n
items_per_page
\nSets the number of feed items to display on each page.
\n
\n
types
\nOnly press releases of the specified types will be included.
\n
\n
image_style
\nThe image style to use:
\n
- DownloadUrl
- UrlTo100x100ArResized
- UrlTo200x200ArResized
- UrlTo400x400ArResized
- UrlTo800x800ArResized
- UrlTo100x100Thumbnail
- UrlTo200x200Thumbnail
\n
\n
show_excerpt
\nDisplay excerpt for each feed item.
\n
\n
template
\nThe 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
\ntheme or in the plugin will be used as a default.
\nYou 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.
\n
\n
flush
\nClears the cache for the block.
\n

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 types=\"PRM, RDV\" start=2016-01-12 end=2019-06-12 image_style=UrlTo400x400ArResized show_filters=1 filter_all_text=*none* filter_regulatory_text=Regulatory filter_non_regulatory_text=Non-regulatory template=foo.php flush=true]\n

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

Here is a complete list of the different kind of press releases:

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 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.
\nIf for some reason you would like to hide a specific filter button you can enter 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
\nthis 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.
\nTo 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\n/**\n * Template name: Foo\n * Template Post Type: cision-block-post\n *\n * Template used to display a feed from Cision.\n **/\n?>\n

Display single press releases in WordPress

Since version 2.0.0 it is possible to fetch and display press releases directly from within WordPress.
\nThe template used in this case is cision-block/templates/cision-block-post.php, you can override
\nthis 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.
\nUnder the Resources section there is a link that explains all the different fields that is available.
\nFor example if you use the $CisionItem->HtmlBody to display content from the feed item you might have to add custom
\ncss 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]\n
- DownloadUrl
- Description
\n

Filters

Add more fields to each feed item:

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

Customize the sorting of the feed items:

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

Add custom attributes to the pager:

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

Set a custom class for active pager item:

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

To add attributes to the section wrapper in the template:

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

To add attributes to the article wrapper in the template:

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

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

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

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

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

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 cisionblock@gmail.com 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:
\nhttps://wordpress.org/support/plugin/cision-block

You can also try contacting me on slack.

\n","installation":"

Upload cision-block to the /wp-content/plugins/ directory,
Activate the plugin through the Plugins menu in WordPress.
Add your feed identifier and configure the plugin at /wp-admin/options-general.php?page=cision-block in WordPress.
You can then add either a shortcode or set up a widget in order to display the feed.

\n","faq":"\n

\nWhere can I get the Premium version?\n\n

You can contact me by sending on an email to: cisionblock@gmail.com.

\nCan I fetch more than the last 50 news?\n\n

You will need to use the Pro version or an addon in order to do this.

\nHow do I get a unique feed identifier?\n\n

This is something that Cision will provide you with.
\nYou can contact them at support@cision.com.

\nPossible to have more than 1 identifier?\n\n

There is possible to use separate feed identifiers for different blocks by using the
\nsource_uid attribute in the shortcode as in this example:

[cision-block source_uid=A275C0BF733048FFAE9126ACA64DD08F]\n

\nPossible to create multiple blocks?\n\n

Yes it is possible to have multiple blocks by simply adding shortcode arguments for each block.

\nCan I use normal permalinks for the news?\n\n

This is something that is possible using the Pro version, since all news are imported as custom posts into WordPress.

\n\n","changelog":"

= Latest

Filter out premium settings.

\n","screenshots":"

$\"A$
A feed from Cision with a pager at the bottom.
$\"Settings$
Settings form.
$\"A$
A single press release displayed in WordPress.
$\"Ticker$
Ticker module. Available in the Pro version.
$\"Subscription$
Subscription module. Available in the Pro version.
$\"Ownership$
Ownership module. Available in the Pro version.
$\"Insider$
Insider module. Available in the Pro version.
$\"Share$
Share Graph module. Available in the Pro version.
$\"A$
A Share Graph and a pie chart.
$\"Shareholder$
Shareholder areas. Available in the Pro version.

"},"short_description":"This plugin adds a shortcode and a widget that can be used for pulling and displaying press releases from Cision.","download_link":"https://downloads.wordpress.org/plugin/cision-block.4.2.0.zip","screenshots":{"1":{"src":"https://ps.w.org/cision-block/assets/screenshot-1.png?rev=1934804","caption":"A feed from Cision with a pager at the bottom."},"2":{"src":"https://ps.w.org/cision-block/assets/screenshot-2.png?rev=2117067","caption":"Settings form."},"3":{"src":"https://ps.w.org/cision-block/assets/screenshot-3.png?rev=2134529","caption":"A single press release displayed in WordPress."},"4":{"src":"https://ps.w.org/cision-block/assets/screenshot-4-en.png?rev=3110646","caption":"Ticker module. Available in the Pro version."},"5":{"src":"https://ps.w.org/cision-block/assets/screenshot-5.png?rev=2651836","caption":"Subscription module. Available in the Pro version."},"6":{"src":"https://ps.w.org/cision-block/assets/screenshot-6-en.png?rev=3110646","caption":"Ownership module. Available in the Pro version."},"7":{"src":"https://ps.w.org/cision-block/assets/screenshot-7.png?rev=3109332","caption":"Insider module. Available in the Pro version."},"8":{"src":"https://ps.w.org/cision-block/assets/screenshot-8.png?rev=3109310","caption":"Share Graph module. Available in the Pro version."},"9":{"src":"https://ps.w.org/cision-block/assets/screenshot-9.png?rev=3046448","caption":"A Share Graph and a pie chart."},"10":{"src":"https://ps.w.org/cision-block/assets/screenshot-10-en.png?rev=3110646","caption":"Shareholder areas. Available in the Pro version."}},"tags":{"cision":"cision","feed":"feed","ir":"ir","press":"press","stock":"stock"},"versions":{"4.1.0":"https://downloads.wordpress.org/plugin/cision-block.4.1.0.zip","4.2.0":"https://downloads.wordpress.org/plugin/cision-block.4.2.0.zip","trunk":"https://downloads.wordpress.org/plugin/cision-block.zip"},"donate_link":"https://www.buymeacoffee.com/cyclonecode","icons":{"1x":"https://ps.w.org/cision-block/assets/icon-128x128.png?rev=1711625","2x":"https://ps.w.org/cision-block/assets/icon-256x256.png?rev=1711625"}},{"name":"Cision Modules","slug":"cision-modules","version":"1.0.1","author":"Cyclonecode","author_profile":"https://profiles.wordpress.org/cyclonecode/","requires":"4.0.0","tested":"5.6.14","requires_php":"7.1","requires_plugins":[],"rating":0,"ratings":{"1":0,"2":0,"3":0,"4":0,"5":0},"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"downloaded":534,"last_updated":"2021-02-13 3:23am GMT","added":"2021-01-30","homepage":"https://wordpress.org/plugins/cision-modules/","sections":{"description":"

This plugin can be used to display tickers from Cision.

Shortcode

The shortcode [cision-ticker] 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.
\nAt the moment the shortcode will only render the associated label with price and currency for each ticker.

If there is other data that you need to display, please contact me and perhaps we can make a small addition for this.

Support

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

You can also try contacting me on slack.

\n","installation":"

Upload custom-post-field to the /wp-content/plugins/ directory,
Activate the plugin through the Plugins menu in WordPress.
You can now configure the plugin by going to wp-admin/tools.php?page=cision-modules.
Add your API KEY and save the form.
Enable the tickers you would like to use and any label you would like to use.
Save the form.

\n","changelog":"

= 1.0.1
\n– Removed dependency from composer.json.
\n– Refactor for PHP 7.1.
\n– Add support to enable specific tickers.

\n","screenshots":"

$\"A$
A page using data for two tickers fetched from Cision.
$\"The$
The plugin configuration form.

"},"short_description":"This plugin aims to add support for different cision modules.","download_link":"https://downloads.wordpress.org/plugin/cision-modules.1.0.1.zip","screenshots":{"1":{"src":"https://ps.w.org/cision-modules/assets/screenshot-1.png?rev=2466584","caption":"A page using data for two tickers fetched from Cision."},"2":{"src":"https://ps.w.org/cision-modules/assets/screenshot-2.png?rev=2466584","caption":"The plugin configuration form."}},"tags":{"cision":"cision","modules":"modules","ticker":"ticker"},"versions":{"1.0.0":"https://downloads.wordpress.org/plugin/cision-modules.1.0.0.zip","1.0.1":"https://downloads.wordpress.org/plugin/cision-modules.1.0.1.zip","trunk":"https://downloads.wordpress.org/plugin/cision-modules.zip"},"donate_link":"https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=PBTHN3L67QA2S&source=url&lc=US&item_name=Cision+Modules","icons":{"1x":"https://ps.w.org/cision-modules/assets/icon-128x128.png?rev=2471998","2x":"https://ps.w.org/cision-modules/assets/icon-256x256.png?rev=2471998"}}]

cision

Cision Block

Cision Modules

Get New Themes & Resources