Installing the Eofferix module for UMI.CMS

How to install the Eofferix module on a UMI.CMS site: prepare the archive, run the installer as an administrator, verify the module, and remove the installer folder.

The Eofferix module lets a UMI.CMS site receive data from an Eofferix profile: products, offers, sections, images, files, and additional fields. The module is installed on the UMI.CMS site; the import profile itself is configured in Eofferix.

What You Need

  • Access to the UMI.CMS site root via FTP, SFTP, SSH, or the hosting file manager.
  • Access to the UMI.CMS administration panel as a user with administrative rights.
  • The eofferix-umi-install.zip archive or the regular module archive eofferix-umi-cms-module.zip.

Recommended Option: Self-Installer Archive

  1. Sign in to the UMI.CMS admin panel in the same browser where you will open the installer.
  2. Download and unpack eofferix-umi-install.zip on your computer.
  3. Upload the eofferix-umi-install folder to the UMI.CMS site root, next to the main index.php.
  4. Open https://site.com/eofferix-umi-install/install.php in the browser.
  5. Wait for the Eofferix module installed message.
  6. Open /admin/eofferix/config/ and check that the module is enabled.
  7. Delete the eofferix-umi-install folder from the site.

The folder must be placed in the site root, not inside classes, images, or another system directory.

public_html/
  index.php
  classes/
  eofferix-umi-install/
    install.php
    index.php

Manual Installation With The Module Archive

If the hosting provider blocks the installer PHP file and shows Forbidden, use the regular eofferix-umi-cms-module.zip archive.

  1. Unpack the archive into the UMI.CMS site root.
  2. Check that /classes/components/eofferix/class.php exists.
  3. Register the module through standard UMI.CMS tools or run the module install file from an administrator environment.
  4. Open /admin/eofferix/config/ and check that the module is shown.

Connecting From Eofferix

After installation, create or open a profile in Eofferix, choose the UMI.CMS template, enter the site address, and run the connection check. Administrator login and password are needed only for the initial connection; the module does not store the administrator password.

When the check succeeds, Eofferix can send prepared data to the UMI.CMS module when the profile runs.

Common Errors

SituationWhat to check
The browser shows Forbidden.The hosting provider blocks PHP execution in that folder. Upload the folder to the site root or use manual installation with the module archive.
The site page opens with 404.Check that the folder is named eofferix-umi-install, is placed next to the main index.php, and the URL ends with /install.php.
The installer asks you to sign in.Sign in to UMI.CMS in the same browser first, then open the installer again.
The module is not visible in the admin panel.Check that /classes/components/eofferix/class.php exists and open /admin/eofferix/config/.
Eofferix cannot connect to the site.Check that the site is available over HTTPS, the module is enabled, and the site address in the profile does not include extra paths or temporary parameters.

What To Remove After Installation

After successful installation, delete the eofferix-umi-install folder from the site. The module will remain installed because its working files have already been copied to the UMI.CMS system directories.