Wordpress celum:connect is a Wordpress extension which allows you to download assets from CELUM via the CELUM Asset Picker directly into the Wordpress filesystem. ![Wordpress](https://img.shields.io/wordpress/plugin/v/celumconnect) ![Asset-Picker](https://img.shields.io/static/v1?label=UI&message=Asset-Picker&color=lightgrey) ## 1. Requirements + Wordpress 4.x or Wordpress 5.x + Celum CORA + [Direct Download](/celum_extensions/direct_download) ## 2. Installation + Login into the Wordpress backend as an administrator + Go To _Plugins_ + From the [store](https://wordpress.org/plugins/celumconnect): click on *Add new*, search for _celum:connect_ and install it + Manual installation: Click on _Upload Plugin_, upload the _celum:connect_ Plugin and click on _Install Now_ + Go To _Settings_ -> _celum:connect Options_ + Configure the API-key (from the CMA in CELUM) + Define the root-nodes (comma separated) + Enter the license key (delivered by brix IT Solutions) ![wordpres_connect_options](wordpress_connect_options.png) ## 3. Configuration + On the _Celum:connect Options_ page, enter the IDs for the default download formats (Image, Unknown, Document, Video Text, Audio) and the supported download formats. + The usage is stored in the node-ref information field defined in the Direct Download property. Specify the consumer name for downloading and for linking assets (this name will be sent to CELUM when an asset was downloaded or linked as a usage reference). The consumer name will be added as node-ref value automatically if it does not yet exist. + Select the right Asset Picker Version for your CELUM installation ### 3.1. Compatibility Matrix | REST API version | CELUM 6 | CELUM 5.13.x | CELUM 5.12.x | Asset Picker version | | ---------------- | ------------ | ------------ | ------------ |--------------------- | | rest-all-2.1 | | 5.13.0 (+) | 5.12.3 (+) | 2.0 | | rest-all-2.1 | | 5.13.2 (-) | | 2.1 | | rest-all-2.2 | | 5.13.0 (+) | 5.12.3 (+) | 2.0 | | rest-all-2.2 | | 5.13.2 (-) | | 2.1 | | rest-all-2.3 | | 5.13.0 (+) | 5.12.3 (+) | 2.0 | | rest-all-2.3 | | 5.13.2 (-) | | 2.1 | | rest-all-3.0 | | 5.13.1 (+) | | 2.2 | | rest-all-3.0 | | 5.13.2 (-) | | 2.3 | | rest-all-3.1 | | 5.13.2 (+) | | 2.3 | | rest-all-3.2 | | 5.13.3 (+) | | 2.4 | | rest-all-3.2 | | 5.13.3 (+) | | 2.5 | | rest-all-3.3 | | 5.13.3 (+) | | 2.5.1 | | rest-all-3.3 | | 5.13.3 (+) | | 2.5.2 | | rest-all-4.0 | 18.12 (+) | | | 3.0 | | rest-all-4.1 | 19.3 (+) | | | 3.0 | | rest-all-4.2 | 19.6 (+) | | | 3.0 | | rest-all-5.0 | 19.12 (+) | | | 3.0 | | rest-all-6.8.11 | 20.9 (+) | | | 6.8.11 | | rest-all-6.9.3 | 21.2 (+) | | | 6.9.3 | | rest-all-6.10.2 | 21.5 (+) | | | 6.10.2 | + (+) The version is the first maintenance version in which a previously unsupported feature is added. + (-) The version is the first maintenance version in which a previously supported feature is removed. ## 4. Usage (<= Wordpress 4) + Login into the Wordpress backend + Go to _Posts_ -> _Add New_ + Click on _Add Media_ + Select _celum:connect_ on the left panel + Choose between "Load assets to Wordpress" and "Link assets from Celum" + Select the desired asset(s) and click on the shopping cart button + Choose the desired download format(s) and download the asset(s) into Wordpress. ![wordpres_connect_add_post](wordpress_connect_add_post.png) ![wordpres_connect_AssetPicker](wordpress_connect_AssetPicker.png) ## 5. Usage (>= Wordpress 5 -> Gutenberg-Editor) with celum:connect block + Login into the Wordpress backend + Go to _Posts_ -> _Add New_ + Add a celum:connect block + Select "Add Assets" + Choose between "Load assets to Wordpress" and "Link assets from Celum" on right panel + Select the desired asset(s) and click on the shopping cart button + Choose the desired download format(s) and download the asset(s) into Wordpress. ![wordpress_connect_add_block](wordpress_connect_add_block.png) ![wordpress_connect_block](wordpress_connect_block.png) ## 6. Usage (>= Wordpress 5 -> Gutenberg-Editor) with the wordpress media module + Login into the Wordpress backend + Go to a place where you can add media from the wordpress media module (e.g in an image block or in the "set features image" dialog) + Select Media library + Go to tab Celum:connect + Select the desired asset(s) and click on the shopping cart button + Choose the desired download format(s) and download the asset(s) into Wordpress. ![wordpress_connect_featured_image](wordpress_connect_featured_image.png) ## Troubleshooting * CORS error: Check if your wordpress is in `security.csrfProtection.trustedUrls`. * No previews: Check if the CORA response delivers the correct URL for binaries. If not, open `celum/server/app/conf/security.xml` and in the `` section, make sure that `proxyName=` equals your `applicationserver.url` from the environment.properties. ## Release Notes ##### 1.0 > Released 2016-07-06 + Initial version ##### 1.1 > Released 2018-02-01 + Added tracking of downloaded assets with "Direct Download" ##### 1.2 > Released 2018-04-06 + Added possibility to choose between "Load assets to Wordpress" and "Link assets from Celum" ##### 1.3 > Released 2018-07-18 + Added support for different Asset Picker Versions (2.0 - 2.4), selectable in the celum:connect Options + Configurable usage for link and for download ##### 1.4 > Released 2019-01-29 + Asset Picker version 2.5 and 2.5.2 added + Code cleaning, sanitizing and validation added for Wordpress guidelines (conditions for wordpress plugin store) ##### 2.0 > Released 2019-03-04 + Gutenberg block support added ##### 2.2 > Released 2019-09-12 + License expiration date possible ##### 2.3 > Released 2019-12-03 + Asset Picker version 3.0 added ##### 2.9 > Released 2020-10-26 + Asset Picker in media module as separate tab ##### 2.14 > Released 2021-04-16 + Asset Picker version 6.8.11 and 6.9.3 added ##### 2.17 > Released 2021-07-07 + Asset Picker version 6.10.2 added