actuel-inactuel/site/plugins/loop/docs/01-installation.md

title
Installation

This guide covers all installation methods for the Kirby Loop plugin.

Prerequisites

Before installing the plugin, ensure your system meets these requirements:

• Kirby CMS: Version 4.0 or higher
• PHP: Version 8.3 or higher
• SQLite: Support enabled (usually included by default in PHP)

Installation Methods

Method 1: Composer (Recommended)

Composer is the preferred installation method

composer require moinframe/kirby-loop

Method 2: Manual Installation

For environments where Composer isn't available or preferred:

1. Download the plugin

   • Visit the GitHub releases page
   • Download the latest version as a ZIP file

2. Extract and place

   • Unzip the downloaded archive
   • Rename the folder to loop (remove version numbers)
   • Move the folder to /site/plugins/loop

3. Verify installation

   • The plugin folder should contain index.php and other plugin files
   • Your final structure should be: /site/plugins/loop/index.php

Method 3: Git Submodule

For projects using Git version control, submodules provide a clean way to include the plugin:

git submodule add https://github.com/moinframe/kirby-loop.git site/plugins/loop

Next Steps

After successful installation:

1. Configuration: See Configuration Guide for customization options
2. Multi-language: If using multiple languages, review Multi-language Setup
3. API Integration: For custom implementations, check the API Reference

Updating

Composer Updates

composer update moinframe/kirby-loop

Manual Updates

1. Download the new version
2. Replace the plugin folder (backup first!)
3. Clear any caches

Git Submodule Updates

git submodule update --remote site/plugins/loop
git add site/plugins/loop
git commit -m "Update loop plugin"

Uninstallation

To remove the plugin:

1. Remove plugin files:

   • Composer: composer remove moinframe/kirby-loop
   • Manual: Delete /site/plugins/loop/ folder
   • Git submodule: git submodule deinit site/plugins/loop

2. Clean up data (optional):

   • Delete /site/logs/loop/ directory to remove all comments
   • Remove configuration from site/config/config.php

3. Clear caches: Clear any site caches to ensure complete removal