From 5c20f5d3e65fdae85c1d42c88e0600d5b5b7efe8 Mon Sep 17 00:00:00 2001 From: lars Date: Sat, 24 Dec 2005 11:42:11 +0000 Subject: [PATCH] some small release fine tunings --- ezmlm-web-3.0/CHANGES | 3 ++- ezmlm-web-3.0/INSTALL | 39 ++++++++++++++----------------- ezmlm-web-3.0/INSTALL.clearsilver | 34 +++++++++++++++++++++++++++ ezmlm-web-3.0/README | 8 +++---- ezmlm-web-3.0/UPGRADING | 6 ++--- ezmlm-web-3.0/ezmlmwebrc | 5 ++-- 6 files changed, 64 insertions(+), 31 deletions(-) create mode 100644 ezmlm-web-3.0/INSTALL.clearsilver diff --git a/ezmlm-web-3.0/CHANGES b/ezmlm-web-3.0/CHANGES index ff1ca85..7d7a746 100644 --- a/ezmlm-web-3.0/CHANGES +++ b/ezmlm-web-3.0/CHANGES @@ -97,9 +97,10 @@ Version 2.3 - 10/06/02005 * moderator unsubscribe fixed Version 3.0 - 12/21/02005 -* complete interface is rewritten +* complete interface is rewritten for enhanced usability * fixed insecure writing of webusers data * commas are not necessary anymore in webusers file * support for MAIL_DOMAIN config setting * requires the clearsilver template engine * changed directory for safely removed mailinglists + diff --git a/ezmlm-web-3.0/INSTALL b/ezmlm-web-3.0/INSTALL index 2b50592..a4978ea 100644 --- a/ezmlm-web-3.0/INSTALL +++ b/ezmlm-web-3.0/INSTALL @@ -8,7 +8,8 @@ OVERVIEW: 4 - compile cgi wrapper 5 - install cgi wrapper 6 - (optional) configure access control (http authentication) - 7 - final test + 7 - css stylesheet file + 8 - final test ------------------------------------------------------------------------------ @@ -19,17 +20,7 @@ OVERVIEW: modules. Additionally (since v3.0) you have to install clearsilver (a templating - engine). You can download it from http://clearsilver.net. - The following configure options should work well: - ./configure --enable-perl \ - --disable-python \ - --disable-ruby \ - --disable-java \ - --disable-csharp \ - --disable-apache \ - --disable-gettext \ - --disable-remote-debugger - + engine). See INSTALL.clearsilver for details. 1. Get ezmlm-web and extract the archive: tar xzf ezmlm-web-3.x.tar.gz @@ -71,9 +62,9 @@ OVERVIEW: Finally, copy the ezmlmwebrc file to one of the following places: - 1) /etc/ezmlm - 2) the home directory of the user that runs ezmlm-web.cgi - 3) the directory, that contains your ezmlm-web.cgi file + 1) the home directory of the user that runs ezmlm-web.cgi + 2) the directory, that contains your ezmlm-web.cgi file + 3) /etc/ezmlm (ezmlm-web will look for it in these places in the given order) @@ -97,10 +88,6 @@ OVERVIEW: access controlled (here I mean both web and user access) by some method (eg .htaccess, access.conf for Apache). - You should also copy the stylesheet file (css/default.css) to a location - of your choice. Now you may have to change the "HTML_CSS_FILE" setting - in your ezmlmwebrc file. - 6. Install some method of securing access to the page. The following information is applicable to Apache web servers ... Detailed @@ -133,14 +120,24 @@ OVERVIEW: AuthUserFile /path/to/passwordfile require valid-user # or require user username - Again, see the ApacheWeek article for details. + Again, see the ApacheWeek article for details. -7. Test the installation with your favourite web browser. You should be +7. You should copy the stylesheet file (css/default.css) to a location + of your choice. It has to be accessible by an URL - maybe a place like + "/var/www/ezmlm-web.css" could be appropriate. + Now you may have to change the "HTML_CSS_FILE" setting in your + ezmlmwebrc file. This value is a URL - not the local filename. + + +8. Test the installation with your favourite web browser. You should be asked for a username and password (supplied in 6.2) and then be presented with a screen entitled "EZ Mailing List Manger". You can then try to create and edit mailing lists ... Have Fun :) + If you do not see a colorful screen, then you did not set the HTML_CSS_FILE + option correctly in ezmlmwebrc. Check it again. + If anything failes - take a look at the web server's error log (e.g /var/log/apache/error.log). diff --git a/ezmlm-web-3.0/INSTALL.clearsilver b/ezmlm-web-3.0/INSTALL.clearsilver new file mode 100644 index 0000000..484bfe0 --- /dev/null +++ b/ezmlm-web-3.0/INSTALL.clearsilver @@ -0,0 +1,34 @@ +Short notes on how to install clearsilver for perl: +(you should read it, as step 4 is quite unusual) + +1) download & untar + http://clearsilver.net + + +2) configure + +The following configure options should be sufficient: + ./configure --enable-perl \ + --disable-python \ + --disable-ruby \ + --disable-java \ + --disable-csharp \ + --disable-apache \ + --disable-gettext \ + --disable-remote-debugger + +3) make + + +4) the tricky part :) + +As the installation directory of clearsilver-perl is configured incorrectly, +you should replace the existing SITEPREFIX line in perl/Makefile with the following: + SITEPREFIX = $(PREFIX) +(without the leading white space) + + +5) make install + + +6) done diff --git a/ezmlm-web-3.0/README b/ezmlm-web-3.0/README index 23fe360..69f3dd2 100644 --- a/ezmlm-web-3.0/README +++ b/ezmlm-web-3.0/README @@ -97,7 +97,7 @@ This version of ezmlm-web requires the following; * qmail v1.03 * ezmlm v0.53 (or ezmlm-idx v0.40) -* clearsilver v0.9.14 (only perl support is necessary) +* clearsilver v0.10.2 (only perl support is necessary) * Perl v5.004 and the following modules; + Mail::Ezmlm v0.03 + Mail::Address v1.15 @@ -224,9 +224,9 @@ the same effect in a cleaner way. VII. Language Portablity ========================= One of the great new features of version 2.0 is that it is essentially -language independant (okay, not quite, but is 99% of the way there). Most of -the fixed strings, help, etc is defined in the files of lang directory. -Of course you can change them or create a new translation. +language independant. All of the fixed strings, help, etc is defined in the +files of lang directory. Of course you can change them or create a new +translation. The language can be selected in ezmlmwebrc with the "HTML_LANGUAGE" option. diff --git a/ezmlm-web-3.0/UPGRADING b/ezmlm-web-3.0/UPGRADING index a0a51d7..818d3e6 100644 --- a/ezmlm-web-3.0/UPGRADING +++ b/ezmlm-web-3.0/UPGRADING @@ -12,9 +12,9 @@ UPGRADING ezmlm-web 2.3 to ezmlm-web 3.0 4) maybe you want to define "MAIL_DOMAIN" in your ezmlmwebrc -5) search order for ezmlmwebrc changed -from HOME->SYSTEM->CGI_DIR -to HOME->CGI_DIR->SYSTEM +5) the search order for ezmlmwebrc has changed +from HOME -> SYSTEM -> CGI_DIR +to HOME -> CGI_DIR -> SYSTEM ------------------------------------------------------------------------------ diff --git a/ezmlm-web-3.0/ezmlmwebrc b/ezmlm-web-3.0/ezmlmwebrc index 9ff1d0b..14e172b 100644 --- a/ezmlm-web-3.0/ezmlmwebrc +++ b/ezmlm-web-3.0/ezmlmwebrc @@ -25,7 +25,7 @@ $LANGUAGE_DIR = "/usr/local/share/ezmlm-web/lang"; $TEMPLATE_DIR = "/usr/local/share/ezmlm-web/template"; # Safe list deletion? -# 0 = move list to .list and the .qmails to deleted.qmail/. Recoverable :) +# 0 = move list to $LIST_DIR/_deleted_lists -> recoverable :) # 1 = allow user to delete list completely. No backup, therefore no recovery. $UNSAFE_RM = 0; @@ -55,7 +55,8 @@ $DEFAULT_OPTIONS = 'aBDFGHiJkLMNOpQRSTUWx'; $HTML_TITLE = "ezmlm-web - a mailinglists' administration interface"; # Optional: use a cascading style sheet (css) -$HTML_CSS_FILE = "css/default.css"; +# this is a URL - you have to copy the css file to the right location before +$HTML_CSS_FILE = "/ezmlm-web.css"; # choose a language (en|de) $HTML_LANGUAGE = 'en';