Changes

Jump to navigation Jump to search
1,769 bytes added ,  19:43, 20 March 2022
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 ==
Of course you must installed and configured ezmlm as described here: [[Ezmlm]]
+
<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]]
   −
Add the DAG repository as described here: [[Dag]] and then expand template
+
yum --enablerepo=smecontribs install smeserver-ezmlm-www
   −
expand-template /etc/yum.conf
     −
Install de perl dependancy:
+
</tab>
 +
<tab name="For SME 7">
 +
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:<br />
 +
 
 +
You need to activate the [[Dag]] reposity before installing this contrib.<br />
 +
 
 +
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 (wait for sync the mirrors) the following two rpm:
+
Install ezmlm-www:
 +
 
 +
yum --enablerepo=smecontribs install perl-Mail-Ezmlm-Archive smeserver-ezmlm-www
 +
</tab>
 +
</tabs>
 +
 
 +
== 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"
   −
  wget http://mirror.contribs.org/smeserver/contribs/nhall/sme7/rpm/ezmlm-www/contribs/perl-Mail-Ezmlm-Archive-0.16-1.noarch.rpm
+
then with cli you should do
  wget http://mirror.contribs.org/smeserver/contribs/nhall/sme7/rpm/ezmlm-www/contribs/smeserver-ezmlm-www-1.4.5-01.noarch.rpm
+
  db accounts setprop MYLIST DisplayArchives enabled
 +
  signal-event smeserver-ezmlm-www-update
   −
and install
+
then run
 +
/etc/e-smith/events/actions/ezw-search-create
   −
yum localinstall perl-Mail-Ezmlm-Archive-0.16-1.noarch.rpm smeserver-ezmlm-www-1.4.5-01.noarch.rpm
+
and voila, next a cron task will handle the update hourly
      −
== Configuration ==
+
if one of your list is displaying but show no month, this is because it was not previously archived / indexed , the workaround :
I have explain the basic steps to run ezmlm-www. You can read the README file under /opt/mailinglist to customize your list.
     −
Open the file '''config.pm''' and replace the string '''''PUT_YOUR_LISTNAME_HERE''''' with the name of your ezmlm list.
+
ezmlm-archive  /home/e-smith/files/ezmlm/lists/MYLIST
   −
And say as README file configure the following parameters:
     −
==> name
  −
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.
+
Access at '''''http://yourserver/mailinlist''''' and see if run ok.
   −
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.
+
Note that indexing is done incrementally, so it will be faster when just updating.
   −
Now launch '''ez_indexer.pl''' from the command line to index your existing messages (it may take a while!) to use the search function:
+
== 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].
 +
{| 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.
 +
|
 +
|}
   −
  /opt/mailinglist/search/ez_indexer.pl --create --verbose
+
  db accounts setprop MYMAILINGLIST search enabled
 +
signal-event smeserver-ezmlm-www
   −
And then add it to crontab. Create a file named '''ezw-search''' and add this content:
     −
#!/bin/bash
+
here are some properties against the ezmlm key in the db configuration
cd /opt/mailinglist/search
+
{| class="wikitable"
./ez_indexer.pl --update
+
!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
 +
|} 
   −
Save and correct perms:
+
config setprop ezmlm lang tr ListServerName 'My personal mailing list browsable web archive'
 +
expand-template /opt/mailinglist/config.pm
   −
chmod 755 ezw-search
+
== The End ==
chown root.root ezw-search
+
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.
   −
Then move under '''/etc/cron.hourly'''
+
This is my first RPM package. If you have found a bug, please tell me about that.
   −
Note that indexing is done incrementally, so it will be faster when just updating.
+
=== 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:Mail]]
Super Admin, Wiki & Docs Team, Bureaucrats, Interface administrators, Administrators
3,250

edits

Navigation menu