Rokka Integration

Description

The rokka image converter supports you in storing your digital images – easy and neat. Whether for handling image formats, SEO attributes or the lightning fast delivery, rokka is just the right tool for your digital images.
This WordPress plugin integrates the rokka image service. All images from your image libary will be synchronized to your rokka account and be served directly through rokka.

Further Information

Screenshots

  • Media management with rokka integration
  • Rokka settings
  • Rokka stack synchronization
  • Rokka mass uploader

Installation

  1. Upload the rokka-integration directory into the /wp-content/plugins/ directory
  2. Activate the plugin through the Plugins menu in WordPress
  3. Add your rokka credentials in the rokka settings (Settings > Rokka Settings)
  4. Synchronize your image sizes to rokka (Settings > Rokka Settings > Sync stacks)
  5. Enable rokka support (Settings > Rokka Settings > Enable rokka integration)
  6. Start uploading your images to rokka via mass uploader (Settings > Rokka Settings > Mass upload/delete) or image by image in the media management (Media (list mode))

FAQ

Installation Instructions
  1. Upload the rokka-integration directory into the /wp-content/plugins/ directory
  2. Activate the plugin through the Plugins menu in WordPress
  3. Add your rokka credentials in the rokka settings (Settings > Rokka Settings)
  4. Synchronize your image sizes to rokka (Settings > Rokka Settings > Sync stacks)
  5. Enable rokka support (Settings > Rokka Settings > Enable rokka integration)
  6. Start uploading your images to rokka via mass uploader (Settings > Rokka Settings > Mass upload/delete) or image by image in the media management (Media (list mode))
What will happen to my image sizes?

You can synchronize all defined image sizes as so called stacks to rokka.

An image from rokka can’t be loaded anymore. What should I do?

If an image which was previously uploaded to rokka can’t be loaded anymore try comparing the rokka hash in the WordPress attachment edit screen with the hash of the image on rokka.io (https://rokka.io/dashboard/) itself.
If it doesn’t match anymore just copy & paste the hash from rokka.io to the WordPress attachment edit screen and save the image.

What is the stack prefix used for?

When synchronizing image sizes from WordPress to rokka the name of the size will be prefixed with this value to create a new stack on rokka.
By prefixing the rokka stack names we ensure that already existing stacks on rokka won’t be overwritten.
Additionally we are able to identify deleted image sizes on WordPress and delete them on rokka as well.

I created a new / changed an existing size in WordPress. What do I have to do now?

Everytime you change something on your size configuration in WordPress you need to re-synchronize the sizes with the rokka stacks.
You can do this in the rokka settings (Settings > Rokka Settings > Sync stacks).

Have you found a bug or do you have a feature request?

Please create a new GitHub issue and let us know: https://github.com/rokka-io/rokka-wordpress-plugin/issues

Contributors & Developers

“Rokka Integration” is open source software. The following people have contributed to this plugin.

Contributors

Translate “Rokka Integration” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.

Changelog

1.2.3

  • [FEATURE] Add unit tests to test url filtering
  • [UPDATE] Updated rokka-client-php to v1.0.0
  • [FIX] Fix URL filtering when creating srcset
  • [FIX] Use correct filenames for different sizes
  • [FIX] There shouldn’t be an upload error when it’s not needed to upload an attachment to rokka

1.2.2

  • [UPDATE] Updated rokka-client-php to v0.10.0
  • [CHANGE] Improved generation of prefixed stack names

1.2.1

  • [FEATURE] Add autoformat option. If autoformat is enabled, rokka will deliver an image in the usually smaller WebP format instead of PNG or JPG, if the client supports it.
  • [FIX] Fix usage of ROKKA_DOMAIN constant

1.2.0

  • [FEATURE] Add possibility to define options with constants. Available constants are: ROKKA_COMPANY_NAME, ROKKA_API_KEY and ROKKA_STACK_PREFIX
  • [FEATURE] Add possibility to overwrite base settings with constants. Available constants are: ROKKA_DOMAIN (default: rokka.io) and ROKKA_SCHEME (default: https)
  • [REMOVE] Removed rokka api secret option since it’s not used anymore

1.1.3

  • [FEATURE] Add Cli-Commands to create stacks and noop-stacks on rokka
  • [CHANGE] Use overwrite option to update existsing stack

1.1.2

  • [FIX] Do not delete rokka image if there are other images with the same hash

1.1.1

  • [CHANGE] Save plugin options as booleans
  • [FIX] Fix a problem with allowed filenames (slugs) on rokka

1.1.0

  • [FEATURE] Added option to define if previous image should be deleted on rokka if metadata changes

1.0.0

  • Initial release of this plugin