Skip to content

5.0.3-p6

Choose a tag to compare

@Swizzler121 Swizzler121 released this 06 Aug 00:36
· 26 commits to master since this release
c21d08d

New Features and Additions:

  • Added time (HH:MM) to start and end for more precise start and end times
  • Added event periods for slideshows which change the used tags, image galleries, delay periods, etc
  • Added Append or Replace options for event periods allowing you to replace all slides or append event slides to the normal rotation
  • Added day-of-the-week recurring slides that only show during that day (Monday, Tuesday, Wednesday, etc)
  • Added ability to set multiple source galleries

Changes:

  • Migrated all functionality into a plugin for easy installation
  • Moved most functions to the /slideshows page which is created upon installation if it does not exist
  • Moved slide builder code from a snippet to a controller
  • Merged Image and Video slides to pull from the same gallery
  • OPAC pages now select the slideshow to use instead of having its own slideshow setup and tags
  • Changed how orientation is fetched to account for controller rendering order

Versioning:

Going forward, the plugin will use the following versioning layout:

#.#.#-p# - where #.#.# is the Kirby version it's built for, and p# is the release number. Since this is the 6th released version (including the version created by the previous developer), this will be 5.0.3-p6

This will also simplify how to tell which version to use depending on your version of Kirby, Mostly avoiding major release differences, and if we ever decide to backport features to older versions of Kirby (I don't really see this happening) that can also be denoted in it's version. the p# is using composers "patch" suffix, I am not sure if this will cause issues in the future, but suffix options in composer are limited. I don't think it will as using the --patch-only function of composer will correctly keep your version with the kirby build # which I can see as being beneficial.

Download & Install

LibSignTool is now a plugin, which simplifies new installation and future upgrades, but upgrading from prior versions will take some work.

New Install

  • Manual Install: Download the release .zip file and extract to your site/plugins folder (should be a folder titled libsigntool-5.0.3-p6)
  • Composer Install: composer require salinapl/libsigntool
  • Git Submodule install: git submodule add https://github.com/salinapl/libsigntool.git site/plugins/libsigntool

After installation, be sure to set your default timezone on the server in the php.ini file or at the top of Kirby's index.php like the following: date_default_timezone_set('America/Chicago');

Upgrade from Prior Version

I apologize for how complex the update is this version, but because of the conversion into a plugin, this should be the last time you will need to put in this much work into an update, and future updates should be much much easier.

  1. Backup your whole site, move a copy of the content folder to somewhere to reference it later.

  2. Delete the following files in the site folder:

    • assets/ (excluding files not created by LibSignTool you have added, assets now handled separately within plugin)
    • site/blueprints/ (excluding files not created by LibSignTool you have added)
    • site/config/config.php (if you have edited the config.php yourself, refer to the last released version to see which lines to remove, mostly to do with landscape/portrait routing, as it's in the plugin now)
    • site/controllers/ (excluding files not created by LibSignTool you have added)
    • site/snippets/ (excluding files not created by LibSignTool you have added)
    • site/templates/ (excluding files not created by LibSignTool you have added)
    • media/ (This folder renders images as needed by Kirby creating thumbnails and such, it's good practice to delete this between Kirby versions, since so much is changing here, we delete it too)
    • You can also delete the .gitignore and LICENSE files, as these are moved to the plugin and mostly for reference.
  3. Delete the content folder, then install the plugin using one of the methods above, on it's first run it will create a slideshows folder.

  4. Before you can load the panel, you will need to create a site.yaml or modify the old one and place it in site/blueprints/. I recommend using the Kirby default site.yml in the KirbyCMS plainkit until you create your own preferred layout. I recommend spinning up a local install of Kirby and installing this plugin there to create your site.yml before the transition.

  5. once in the panel, You can either manually reconfigure the slide content files and re-integrate them, but there's enough changes from prior versions I recommend re-uploading the slide images and re-assigning their start/expire and tags by hand to prevent issues. Video and image content now live in the same folder, image orientation can still be determined automatically, but video content still needs the orientation tag set manually, but since they share a folder both types of content share the field.

  6. OPAC pages are not created on installation, you should be able to move over your existing pages from the content folder, however you will need to reconfigure them as OPAC pages now select a paired slideshow instead of acting as their own slideshow as they previously did.