Instructions for the Koha Celebrations Extension

Description

The Koha Celebrations extension for OPAC allows administrators to
easily customize the public interface of their Koha catalog.
With this plugin, it’s simple to create a seasonal visual atmosphere
that matches every time of the year : Christmas, Halloween,
Valentine’s Day, Easter, and more.

Each theme automatically adjusts the main colors, animations, and
decorative elements of the site.
As a result, your OPAC becomes more dynamic, engaging, and
pleasant to use for your patrons.

Moreover, all customizations : colors, effects, animations, and decorations,
are entirely optional.
Administrators can enable or disable each element individually according to
their preferences or the library’s visual identity.

Download the Koha Extension

Technical Version

You can view the project on GitHub, as it is an
open-source plugin that will include more themes in the future.
Also, feel free to contact us with your feedback, suggestions for improvement,
or ideas for new seasonal themes.

GitHub Link for the Koha Celebrations Extension

Simple Version

You can simply download the .kpz file by clicking the
“Download” button, then import it from the plugin management page
in your Koha intranet.

How to Use the Koha Celebrations Plugin

To access the configuration:

1. Open the Extensions page in Koha.

2. Click Action → Run Tool to launch the Celebrations plugin.

3. If the plugin is not yet activated, a message will prompt you to enable it.

Then follow these steps:

• Select a theme from the list (Christmas, Halloween, etc.).
• Enable or disable visual elements based on your preferences.
• Adjust the settings (size, speed, number, position, etc.) for each effect.
• Finally, save your changes and open your OPAC to enjoy the new look!

Tip: Try different combinations to create a unique and festive experience!

Configuration Menu (Plugin Admin Panel)

The administration menu of the Koha Celebrations plugin is clear and easy to use.
It allows you to manage every aspect of your customization without writing a single line of code.
In addition, all changes are instantly visible in your OPAC interface.

Main Features

• Seasonal Theme Selection:
  Choose from several predefined themes (Christmas, Halloween, Valentine’s Day, Easter, etc.) via the configuration panel.

• Color Customization:
  Each theme applies a specific palette that changes buttons, backgrounds, text, and icons.

• Addition of Modern Visual Elements:
  Snowflakes, pumpkins, hearts, and other dynamic decorations depending on the season.

• Enable/Disable Elements:
  Each animation can be turned on or off independently, providing precise control.

• Advanced Configuration:
  Adjust the size, speed, number of elements, or their direction according to your needs.

Benefits of the Koha Celebrations Extension

• Enhances the visual appeal of your OPAC during key periods.

• Provides an immersive and festive user experience.

• Allows for quick, code-free customization.

• Operates in a modular and flexible manner.

• Encourages user engagement and highlights the catalog effectively.