Download the PHP package cyclonecode/cision-block without Composer

On this page you can find all versions of the php package cyclonecode/cision-block. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Example code of cyclonecode/cision-block

Informations about the package cision-block

=== Cision Block === Contributors: cyclonecode Donate link: https://www.buymeacoffee.com/cyclonecode Tags: cision, feed, investor relation, press, stock, shortcode, widget, content Requires at least: 3.1.0 Tested up to: 6.2 Requires PHP: 5.6 Stable tag: 2.9.1 License: GPLv2 or later License URI: http://www.gnu.org/licenses/gpl-2.0.html

This plugin adds a shortcode and a widget that can be used for pulling and displaying pressreleases from cision.

== 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. 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:

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.

There is also a backlog with features yet to be implemented on github, some of the tasks in the list includes:

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

= Looking for help =

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

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:

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:

= 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:

= 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:

= 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.

== Installation ==

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

== Frequently Asked Questions ==

= Can I fetch more than the last 100 news? =

You will need to use the Pro version to do this.

= How do I get a unique feed identifier? =

This is something that Cision will provide you with. You can contact them at [email protected].

= Possible to have more than 1 identifier? =

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

[cision-block source_uid=A275C0BF733048FFAE9126ACA64DD08F]

= Possible to create multiple cision blocks? =

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

= Can I use normal permalinks for the news? =

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

== Upgrade Notice ==

= 1.4.4 =

= 1.4.8 =

= 1.4.9.1 =

= 2.1.0 =

= 2.4.3.1 =

== Screenshots ==

  1. A feed from cision with a pager at the bottom.
  2. Settings form.
  3. A single press release displayed in Wordpress.
  4. Ticker module. Available in the Pro version.
  5. Subscription module. Available in the Pro version.
  6. Shareholder module. Available in the Pro version.
  7. Insider module. Available in the Pro version.

== Changelog ==

= 2.9.1

All versions of cision-block with dependencies

PHP Build Version
Package Version
Requires composer/installers Version ^1.5
php Version >=5.6
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package cyclonecode/cision-block contains the following files

Loading the files please wait ....