This repository was forked from GitHub and is adapted to the needs of the ECG movement. All changes to the project will be tracked in this repository.

Description

A light PHP web interface for managing mlmmj mailing lists. It does not use a database and is available in English.

Features

For users

Authentication via LDAP
List all available mailinglists on the server
Display owners and listdescription of the respective mailing lists on the index page
Only show the edit function for mailing lists where the user is set as owner
Edit functions per mailing list: subscribers, moderators, prefix and listdescription

For admins

Error handling regarding invalid user input
Strip leading and trailing blanks for subscribers and moderators list
Audit log of changes
Notify admins about errors via Rocket:Chat bot implementation

IMPORTANT

In case of login issues: Please be aware that the password input field gets sanitized using the filter FILTER_SANITIZE_FULL_SPECIAL_CHARS

Installation

Clone the git repository to your webserver:

https://git.ecogood.org/services/mlmmj-light-web-ecg.git

Enter your ECG account credentials and the tool gets downloaded.

Change the values in init.php and you are ready to go:

Variable	Description	Default value
`$lists_path`	Path to the parent directory where the folder named at `$domain_global` is located at	`/home/pacs/ecg00/users/mlmmj`
`$web_path`	Full path to the webinterface	`/home/pacs/ecg00/users/mlmmj/doms/list.ecogood.org/htdocs-ssl/mlmmj-light-web-ecg/`
`$web_url`	URL to the webinterface with leading https://	`https://list.ecogood.org/`
`$language`	As the original tool had two languages this is not relevant anymore. Currently the tool supports English only	`en`
`$domain_global`	Name of the folder within `$lists_path` where all mailing lists are stored	`mlmmj`
`$rc_webhook`	The Rocket:Chat webhook string to be able to send notifications regarding errors	Something like `ohciu8ni2aiBohciu/aikek3eikeche1eech8cumae3hiewuJ1ooqu0reik8feeGho`
`$current_version`	No need to change this	depends on the current version
`$headline`	No need to change this	`Manage your ECG mailing lists " . $current_version`
`$debug`	Turns the debug mode on which prints error messages on the screen	`false`

Restore original templates

If you want to restore the original templates:

Navigate to directory misc
Untar the following two archives:

tar xzvf ./templates.tar.gz -C .
tar xzvf ./smarty.tar.gz -C .

Update

Enter the directory where the files are located.

cd mlmmj-light-web-ecg
git pull

Check if the values from init.php are still valid or need to be adapted.

Changelog

v1.2 - Version 1.2 (2022-02-01)
v1.1 - Version 1.1 (2021-11-25)
v1.0 - Initial release (2021-08-13)

Roadmap

see ROADMAP.md

Wishes / Bugs / Contributions

If you have any feature wish or you found a bug just file an issue in this git repository. Any contribution to this repository is highly appreciated. Don't forget to increase the version number then.