📦 Image Module Example

📙 Introduction

The Suitefish CMS image module template provides a modular framework designed to showcase website deployment capabilities without automatic feature initialization. This enables developers to configure modules, websites, or services manually and integrate them as required. You can download this example module here: Download

• Image modules operate as independent websites.
• Image modules cannot be updated through the administrator interface.
• Image modules are not linked to any site module unless explicitly connected within the code.
• Image modules can contain fully independent websites (such as WordPress or similar platforms) that function independently of the Suitefish core ecosystem.
• Image modules can be included in backup procedures.

🛠️ Installation

1. Method: Login to your suitefish instance and browse our official store on your page. If you find the module you are looking for just download the package. Then navigate to the Image Package Area and enable the downloaded Image module.

2. Method: Navigate to the Image Package Area inside the suitefish instance. Go to the upload section and upload the modules .zip file. Then navigate to the Image Package Area and enable the downloaded image module.

3. Method: Manually upload the entire image module folder—which contains the version.php file—to your Suitefish CMS instance under the path _image/[yourfolder]/version.php. Ensure you copy the complete contents of the folder, not just the version.php file.

📁 Folder Structure

Folder/File	Description	Optional
./_lang	Store your language files in this folder	Optional
./_lang/de.php	Translation File for German	Optional
./_lang/en.php	Translation File for English	Optional
./_lang/es.php	Translation File for Spanish	Optional
./_lang/fr.php	Translation File for French	Optional
./_lang/in.php	Translation File for Hindu	Optional
./_lang/it.php	Translation File for Italian	Optional
./_lang/ja.php	Translation File for Japanese	Optional
./_lang/kr.php	Translation File for Korean	Optional
./_lang/pt.php	Translation File for Portuguese	Optional
./_lang/ru.php	Translation File for Russian	Optional
./_lang/tr.php	Translation File for Turkish	Optional
./_lang/zh.php	Translation File for Chinese	Optional
./_lang/[LANGEUAGECODE].php	Other language Files you may add	Optional
./_lang/index.php	Prevent Directory Listing	Optional
./_licenses	Store your external licenses in this folder	Optional
./_licenses/example.lic	Example License File	Optional
./_licenses/[LIBNAME].lic	Store your other License files here	Optional
./_licenses/index.php	Prevent Directory Listing	Optional
./_htdocs/[WEBSITEFILES]	Put the Website to be deployed in here, this can be any website source code	Mandatory
./preview.jpg	Preview image for the store and other areas the module is visble at	Mandatory
./LICENSE.md	License information about the module	Mandatory
./README.md	Readme file with general information about the module	Mandatory
./changelog.php	File containing changelogs for the latest version only	Mandatory
./version.php	Versioning and meta file of the module	Mandatory
./index.php	Prevent Directory Listing	Optional

📐 Developer Insights

This section provides important information for developers about module development, including essential coding guidelines to be followed prior to submitting or deploying modules.

📋 Code Guidelines

Please follow these coding guidelines when developing modules:

• The module's Rname identifier must be unique.
• If you plan to publicly release your module, request a unique Rname from the Suitefish staff. Otherwise, prefix your module's Rname with "int" to designate it as an internal, non-public module, avoiding duplication.
• Public image modules should have an Rname starting with "img".
• Ensure the Rname does not exceed 20 characters.
• Avoid using special characters in the Rname, as they may cause critical errors.

📚 Language Files

Language files in this type of module are used only to display the name and description in the store for multilingual support. Below is an example of an English language file (en.php). The initial lines restrict public access to the file. The translation variables enable the store to present the name and description in multiple languages.

<?php if(isset($this)) { if(!is_object($this)) { Header("Location: ../"); exit(); } } else { Header("Location: ../"); exit(); } ?>

store_version_name=Template: Image Module
store_version_description=Suitefish CMS extension template for developers, providing a modular framework to demonstrate website deployment capabilities without automatic feature initialization, enabling custom configuration and manual module integration.

📝 Changelog File

Changelog of changes between this and last version of this module. Store the changelog in simple html format in the $x variable.

$x = "<b>Release 1.10.100</b><br /> - Initial Release";

🏷️ Version File

This file (version.php) contains detailed information about the module, all variables are mandatory and should be set on a module.

Variable	Description	Example / Notes
$x["rname"]	Unique module identifier.	"_image"; max 15 chars, no special chars or numbers; start with "xxx" if not registered.
	Contact suitefish staff to register for official public store ID.	Underscore prefix reserved for Suitefish official releases.
$x["lang"]	Supported languages expressed as short codes in a PHP array.	array("en", "de", "fr", "it", "es", "zh", "ja", "in", "kr", "pt", "ru", "tr")
$x["build"]	Build number (integer only).	"100"; used for version extensions and database updates.
$x["version"]	Full module version, including main and build numbers.	"1.10.100" (example uses build number appended).
$x["name"]	Module name displayed on front-end areas. Plain text only, no HTML allowed.	"Template: Image Module"
$x["description"]	Module description shown on front-end areas. Allows simple HTML tags (br, li, table).	"Suitefish CMS extension template for developers..."
	No scripts, styles, or complex tags allowed.	Mandatory field.
$x["type"]	Module type identifier (1=Site, 2=Extension, 3=Image, 4=Windows, 5=Docker, 6=Theme).	3 (for image modules)
$x["cms_version_min"]	Minimum Suitefish CMS version required for this module.	"7.10.100"
$x["license"]	Module license identifier (e.g., gplv3, mit, bsd).	Can be set to false if none.
$x["author"]	Name of module author.	"Suitefish"; can be false.
$x["mail"]	Email address of the module author.	false if not provided.
$x["website"]	Website URL of the module or author.	false if not provided.
$x["documentation"]	URL to module documentation.	"https://bugfishtm.github.io/suitefish-cms/"
$x["github"]	GitHub repository URL for the module.	"https://github.com/bugfishtm/suitefish-cms"
$x["video"]	Video URL related to the module (optional).	false if none.

📄 Documentation

If you are a developer you can find examples of modules in the _developers folder at the suitefish-cms github repository if you want to create an own module! For more information about the Suitefish CMS: https://github.com/bugfishtm/suitefish-cms

🐟 Bugfish