Difference between revisions of "Ezmlm-www"

From SME Server
Jump to navigationJump to search
 
(14 intermediate revisions by 4 users not shown)
Line 1: Line 1:
 +
This is one of the numerous web interface to browse archives of ezmlm. Of course you first need of install ezmlm system and its admin web interface [[Ezmlm|here]]
 +
 +
alternative use could be http://untroubled.org/ezmlm-browse/ but no contribs available
 +
 
== History ==
 
== History ==
Some years ago (2.5) I have published a how-to in the forum http://forums.contribs.org/index.php?topic=27460.0 for install '''mharc''' mailist web publisher in sme6. Now I have found a little but good app to do the same: publish ezmlm archives on the web beautify.
+
Some years ago (2.5) [[User:PicsOne]] has published a how-to in the forum http://forums.contribs.org/index.php?topic=27460.0 for install '''mharc''' mailist web publisher in sme6. Now I have found a little but good app to do the same: publish ezmlm archives on the web beautify.
  
  
Line 6: Line 10:
 
The author is '''Alessandro Ranellucci''' and the aplication is '''ezmlm-www''' and can be found at http://ezmlm-www.sourceforge.net/
 
The author is '''Alessandro Ranellucci''' and the aplication is '''ezmlm-www''' and can be found at http://ezmlm-www.sourceforge.net/
  
 +
=== Version ===
 +
{{ #smeversion: smeserver-ezmlm-www}}
  
 
== Installation ==
 
== Installation ==
 +
<tabs container><tab name="For SME 10">
 +
suggested first install smeserver-ezmlm-web to administer your mailing lists using the server-manager and ezmlm-web see [[ezmlm]]
 +
 +
yum --enablerepo=smecontribs install smeserver-ezmlm-www
 +
 +
 +
</tab>
 +
<tab name="For SME 7">
 
Of course you must have installed and configured ezmlm as described here: [[Ezmlm]]
 
Of course you must have installed and configured ezmlm as described here: [[Ezmlm]]
  
Add the DAG repository as described here: [[Dag]] and then expand template
+
If you do not have the Dag repository configured you should do so:<br />
  
expand-template /etc/yum.conf
+
You need to activate the [[Dag]] reposity before installing this contrib.<br />
  
Install de perl dependancy:
+
see [[dag|dag repository]] <br />
 +
 
 +
 
 +
Install the perl dependancy:
  
 
  yum --enablerepo=dag install perl-Mail-Box perl-User-Identity perl-TimeDate perl-Email-Simple perl-Plucene perl-KinoSearch
 
  yum --enablerepo=dag install perl-Mail-Box perl-User-Identity perl-TimeDate perl-Email-Simple perl-Plucene perl-KinoSearch
  
Download from my home the following two rpm:
+
Install ezmlm-www:
  
  wget http://mirror.contribs.org/smeserver/contribs/nhall/sme7/contribs/ezmlm-www/rpm/perl-Mail-Ezmlm-Archive-0.16-1.noarch.rpm
+
  yum --enablerepo=smecontribs install perl-Mail-Ezmlm-Archive smeserver-ezmlm-www
wget http://mirror.contribs.org/smeserver/contribs/nhall/sme7/contribs/ezmlm-www/rpm/smeserver-ezmlm-www-1.4.5-01.noarch.rpm
+
</tab>
 +
</tabs>
  
and install
+
== Basic Configuration ==
 +
unless you do the following step no mailing list will display on your public web interface
  
  yum localinstall perl-Mail-Ezmlm-Archive-0.16-1.noarch.rpm smeserver-ezmlm-www-1.4.5-01.noarch.rpm
+
go to your ezmlm-web admin interface  in the option/archive section to configure your mailing lists to "Archive mailing list messages" and "Index mailing list messages for WWW archive access"
  
 +
then with cli you should do
 +
db accounts setprop MYLIST DisplayArchives enabled
 +
signal-event smeserver-ezmlm-www-update
  
== Configuration ==
+
then run
I have explain the basic steps to run ezmlm-www. You can read the README file under /opt/mailinglist to customize your list.
+
/etc/e-smith/events/actions/ezw-search-create
  
Open the file '''config.pm''' and replace the string '''''PUT_YOUR_LISTNAME_HERE''''' with the name of your ezmlm list.
+
and voila, next a cron task will handle the update hourly
  
And say as README file configure the following parameters:
 
  
==> name
+
if one of your list is displaying but show no month, this is because it was not previously archived / indexed , the workaround :
Full e-mail address of list
 
 
 
==> local_part
 
Chars that comes before che '@' sign in list address.
 
 
 
==> host_part
 
Chars that comes after che '@' sign in list address.
 
 
 
==> description
 
Verbose description of list (for indexing purposes).
 
 
 
==> archive
 
Mail::Ezmlm::Archive object, specify list path.
 
 
 
==> conceal_senders
 
Set this to 1 (otherwise to 0) if you want domains to be replaced by
 
'...' in e-mail addresses to prevent spammers to read them.
 
 
 
==> subscription_info
 
Set this to 1 (otherwise to 0) if you want some info about
 
subscribing and unsubscribing to be put on main list page.
 
 
 
==> default_sorting
 
This may be 'thread', 'date' or 'subject'.
 
 
 
==> descending_by_default
 
Set this to 1 (otherwise to 0) if you want threads to be listed in
 
descending order by default.
 
 
 
==> show_html
 
Set this to 1 (otherwise to 0) if you want to display HTML messages.
 
 
 
==> highlight
 
Set this to 1 (otherwise to 0) if you want to highlight parts of messages.
 
such as replies, signatures, URLs.
 
 
 
==> show_inline_images
 
Set this to 1 (otherwise to 0) if you want to display inline images
 
instead of just a link.
 
 
 
$lang must be 'br', 'en', 'es', 'de', 'no', 'pt' or 'it' depending on your chosen language.
 
  
Access at '''''http://yourserver/mailinlist''''' and see if run ok.
+
ezmlm-archive  /home/e-smith/files/ezmlm/lists/MYLIST
  
Open the file '''ez_indexer.pl''' under '''search''' directory and change the string '''''PUT_YOUR_LISTNAME_HERE''''' with the name of your ezmlm list, as above.
 
  
Now launch '''ez_indexer.pl''' from the command line to index your existing messages (it may take a while!) to use the search function:
 
  
/opt/mailinglist/search/ez_indexer.pl --create --verbose
+
Access at '''''http://yourserver/mailinlist''''' and see if run ok.
  
And then add it to crontab. Create a file named '''ezw-search''' and add this content:
+
Note that indexing is done incrementally, so it will be faster when just updating.
  
  #!/bin/bash
+
== Advanced Configuration ==
cd /opt/mailinglist/search
+
here are some properties available to configure your list for the mailinglist type of the db accounts. They are also all available using the web admin panel provided by the contribution [Ezmlm].
./ez_indexer.pl --update
+
{| class="wikitable"
 +
!property
 +
!default
 +
!values
 +
!description
 +
!available in manager
 +
|-
 +
|DisplayArchives
 +
|disabled
 +
|enabled/disabled
 +
|list or not the archive in the www interface
 +
|
 +
|-
 +
|conceal_senders
 +
|enabled
 +
|enabled/disabled
 +
|Set this to enabled if you want domains to be replaced by
 +
'...' in e-mail addresses to prevent spammers to read them.
 +
|
 +
|-
 +
|Description
 +
|
 +
|string
 +
|Verbose description of list (for indexing purposes).
 +
|yes
 +
|-
 +
|default_sorting
 +
|thread
 +
|thread date or subject
 +
|
 +
|
 +
|-
 +
|show_html
 +
|enabled
 +
|enabled/disabled
 +
|Set this to enabled if you want to display HTML messages.
 +
|
 +
|-
 +
|highlight
 +
|enabled
 +
|enabled/disabled
 +
|Set this to enabled if you want to highlight parts of messages.
 +
such as replies, signatures, URLs.
 +
|
 +
|-
 +
|show_inline_images
 +
|enabled
 +
|enabled/disabled
 +
|Set this to enabled if you want to display inline images
 +
instead of just a link.
 +
|
 +
|-
 +
|subscription_info
 +
|disabled
 +
|enabled/disabled
 +
|Set this to enabled if you want some info about
 +
subscribing and unsubscribing to be put on main list page.
 +
|
 +
|-
 +
|descending_by_default
 +
|enabled
 +
|enabled/disabled
 +
|Set this to enabled if you want threads to be listed in descending order by default.
 +
|
 +
|-
 +
|search
 +
|disabled
 +
|enabled/disabled
 +
|display the search box.
 +
|
 +
|}
  
Save and correct perms:
+
db accounts setprop MYMAILINGLIST search enabled
 +
signal-event smeserver-ezmlm-www
  
chmod 755 ezw-search
 
chown root.root ezw-search
 
  
Then move under '''/etc/cron.hourly'''
+
here are some properties against the ezmlm key in the db configuration
 +
{| class="wikitable"
 +
!property
 +
!default
 +
!values
 +
!
 +
|-
 +
|lang
 +
|system or en
 +
|'bg', 'de', 'en', 'es' , 'fr', 'it', 'no', 'pt' , 'tr', 'zh'
 +
|interface language, if empty will try to use your system language if available or English
 +
|-
 +
|ListServerName
 +
|empty
 +
|string
 +
|display a title for you www interface, default to server name if empty
 +
|} 
  
Note that indexing is done incrementally, so it will be faster when just updating.
+
config setprop ezmlm lang tr ListServerName 'My personal mailing list browsable web archive'
 +
expand-template /opt/mailinglist/config.pm
  
 
== The End ==
 
== The End ==
Line 105: Line 169:
  
 
This is my first RPM package. If you have found a bug, please tell me about that.
 
This is my first RPM package. If you have found a bug, please tell me about that.
 +
 +
=== Bugs ===
 +
Please raise bugs under the SME-Contribs section in {{BugzillaFileBug|product=|component=|title=bugzilla}}and select the smeserver-ezmlm-www component or use {{BugzillaFileBug|product=SME%20Contribs|component=smeserver-ezmlm|title=this link}}.
 +
 +
 +
{{#bugzilla:columns=id,product,version,status,summary |sort=id |order=desc |component=smeserver-ezmlm|noresultsmessage="No open bugs found."}}
 +
 +
===Changelog===
 +
Only released version in smecontrib are listed here.
 +
 +
{{ #smechangelog: smeserver-ezmlm-www}}
 +
  
 
----
 
----
 
[[Category:Contrib]]
 
[[Category:Contrib]]
 
[[Category:Mail]]
 
[[Category:Mail]]

Latest revision as of 18:43, 20 March 2022

This is one of the numerous web interface to browse archives of ezmlm. Of course you first need of install ezmlm system and its admin web interface here

alternative use could be http://untroubled.org/ezmlm-browse/ but no contribs available

History

Some years ago (2.5) User:PicsOne has published a how-to in the forum http://forums.contribs.org/index.php?topic=27460.0 for install mharc mailist web publisher in sme6. Now I have found a little but good app to do the same: publish ezmlm archives on the web beautify.


Author

The author is Alessandro Ranellucci and the aplication is ezmlm-www and can be found at http://ezmlm-www.sourceforge.net/

Version

Contrib 10:
smeserver-ezmlm-www
The latest version of smeserver-ezmlm-www is available in the SME repository, click on the version number(s) for more information.


Installation

suggested first install smeserver-ezmlm-web to administer your mailing lists using the server-manager and ezmlm-web see ezmlm

yum --enablerepo=smecontribs install smeserver-ezmlm-www


Of course you must have installed and configured ezmlm as described here: Ezmlm

If you do not have the Dag repository configured you should do so:

You need to activate the Dag reposity before installing this contrib.

see dag repository


Install the perl dependancy:

yum --enablerepo=dag install perl-Mail-Box perl-User-Identity perl-TimeDate perl-Email-Simple perl-Plucene perl-KinoSearch

Install ezmlm-www:

yum --enablerepo=smecontribs install perl-Mail-Ezmlm-Archive smeserver-ezmlm-www

Basic Configuration

unless you do the following step no mailing list will display on your public web interface

go to your ezmlm-web admin interface in the option/archive section to configure your mailing lists to "Archive mailing list messages" and "Index mailing list messages for WWW archive access"

then with cli you should do

db accounts setprop MYLIST DisplayArchives enabled 
signal-event smeserver-ezmlm-www-update

then run

/etc/e-smith/events/actions/ezw-search-create

and voila, next a cron task will handle the update hourly


if one of your list is displaying but show no month, this is because it was not previously archived / indexed , the workaround :

ezmlm-archive  /home/e-smith/files/ezmlm/lists/MYLIST


Access at http://yourserver/mailinlist and see if run ok.

Note that indexing is done incrementally, so it will be faster when just updating.

Advanced Configuration

here are some properties available to configure your list for the mailinglist type of the db accounts. They are also all available using the web admin panel provided by the contribution [Ezmlm].

property default values description available in manager
DisplayArchives disabled enabled/disabled list or not the archive in the www interface
conceal_senders enabled enabled/disabled Set this to enabled if you want domains to be replaced by

'...' in e-mail addresses to prevent spammers to read them.

Description string Verbose description of list (for indexing purposes). yes
default_sorting thread thread date or subject
show_html enabled enabled/disabled Set this to enabled if you want to display HTML messages.
highlight enabled enabled/disabled Set this to enabled if you want to highlight parts of messages.

such as replies, signatures, URLs.

show_inline_images enabled enabled/disabled Set this to enabled if you want to display inline images

instead of just a link.

subscription_info disabled enabled/disabled Set this to enabled if you want some info about

subscribing and unsubscribing to be put on main list page.

descending_by_default enabled enabled/disabled Set this to enabled if you want threads to be listed in descending order by default.
search disabled enabled/disabled display the search box.
db accounts setprop MYMAILINGLIST search enabled
signal-event smeserver-ezmlm-www


here are some properties against the ezmlm key in the db configuration

property default values
lang system or en 'bg', 'de', 'en', 'es' , 'fr', 'it', 'no', 'pt' , 'tr', 'zh' interface language, if empty will try to use your system language if available or English
ListServerName empty string display a title for you www interface, default to server name if empty
config setprop ezmlm lang tr ListServerName 'My personal mailing list browsable web archive'
expand-template /opt/mailinglist/config.pm

The End

This app can run with mod_perl, but I can't do it. Please, read the readme file, and if you can, please tell me howto, and then I update the package.

This is my first RPM package. If you have found a bug, please tell me about that.

Bugs

Please raise bugs under the SME-Contribs section in bugzilla and select the smeserver-ezmlm-www component or use this link .


IDProductVersionStatusSummary (6 tasks)
12125SME Contribs10.0CONFIRMEDNFR: add the migrate procedure for mailman
11917SME Contribs10.0CONFIRMEDNFR ezmlm-web and ezmlm-www cron script to update indexes, archives and search indexes
11916SME Contribs10.0CONFIRMEDez-indexer fails after about 7000 messages to index
11915SME Contribs10.0CONFIRMEDNFR www archive interface access permission
11914SME Contribs10.0CONFIRMEDwww archive interface kinosearch not working
9473SME Contribs8.2CONFIRMED[ezmlm-web 3.3.1] update db accounts setprop MLname Owner

Changelog

Only released version in smecontrib are listed here.

smeserver-ezmlm-www Changelog: SME 10 (smecontribs)
2022/07/30 Brian Read 2.0.0-12.sme
- Re-build and link to latest devtools [SME: 11997]

2022/07/22 Jean-Philippe Pialasse 2.0.0-11.sme
- add to core backup [SME: 12124]

- update to httpd 2.4 syntax [SME: 12045]
2022/03/20 Jean-Philippe Pialasse 2.0.0-10.sme
- chmod +x ezw-search [SME: 11909]
2022/03/20 Jean-Philippe Pialasse 2.0.0-9.sme
- protect indexes and configuration [SME: 11909]
2022/03/19 Jean-Philippe Pialasse 2.0.0-8.sme
- Re-build and link to latest devtools wide character error preventing to display message [SME: 11912]