Changes

From SME Server
Jump to navigationJump to search
2,816 bytes added ,  07:53, 3 August 2022
no edit summary
Line 1: Line 1:  +
{{Languages}}
 +
<!-- here we define the contrib name variable -->
 +
<!-- we get the page title, remove suffix for translated version; if needed you can define there with the value you want-->
 +
{{#vardefine:contribname| {{lc: {{#titleparts:  {{BASEPAGENAME}} |1}} }} }}
 +
{{#vardefine:smecontribname| smeserver-{{lc: {{#titleparts:  {{BASEPAGENAME}} |1}} }} }}
 +
<!-- we define the language -->
 +
{{#vardefine:lang| {{lc:  {{#titleparts:    {{PAGENAME}} | | -1}}  }} |en }}
 +
 +
 +
{{Infobox contribs
 +
|name={{#var:contribname}}
 +
|image={{#var:contribname}}.png
 +
|description_image= {{#var:contribname}} logo
 +
|maintainer=
 +
|licence=
 +
|url= https://discuss.phplist.org
 +
|category= mailinglist
 +
|tags=mailinglist
 +
}}
 +
 
== Phplist Contribs ==
 
== Phplist Contribs ==
    
===Maintainer===
 
===Maintainer===
[mailto:pierre@firewall-services.com[[User:pierre|Pierre B.]]] from [http://www.firewall-services.com Firewall Services]
+
 
 +
[mailto:daniel@firewall-services.com[[User:VIP-ire|Daniel B.]]] from [http://www.firewall-services.com Firewall Services]
 +
===Version===
 +
{{#smeversion: smeserver-phplist }}
 +
{{#smeversion: phplist }}
 +
[[Version::Contrib9| fws]] [[Has SME9::true| ]]
    
=== Description ===
 
=== Description ===
Phplist is an OpenSources Mailing List tool. It's a web application who is using Php and Mysql to work.
+
[https://www.phplist.com/ '''phpList'''] is an open source software for managing mailing lists. It is designed for the dissemination of information, such as newsletters, news, advertising to list of subscribers. It is written in PHP and uses a MySQL database to store the information.
   −
It can be setup on SmeServer with the contrib smeserver-phplist.
+
=== Requirements ===
 +
You need the [[Fws|firewall-services]] repo to install this contribs
    
=== Installation ===
 
=== Installation ===
 +
<tabs container><tab name="For SME 10">
 +
yum install --enablerepo=smecontribs smeserver-phplist
 +
</tab><tab name="For SME 8.x 9.x">
 +
{{Warning box|Versions of PHPList above 3.2.x will no longer run on the PHP version included in the stock version of SME v9. See: https://sourceforge.net/p/phplist/mailman/message/35670118/. Please refer to [[PHP_Software_Collections]] on how to install PHP 5.6 or higher.}}
   −
{{Note box| To begin, be sure you have the right repository setup on your system.
+
This contrib is currently held in the fws repository, so the following commands will install on your smeserver.
In my example, I will use the firewall-Services repository.}}
  −
 
  −
First, install the smeserver-phplist package. The dependencies will do the others tasks.
  −
 
  −
This will install two packages, on for Phplist, and the second to adapt Phplist for SmeServer.
  −
 
  −
  [root@sme8 ~]# yum install --enablerepo=fws smeserver-phplist
     −
=== Configuration ===
+
yum install --enablerepo=fws smeserver-phplist
   −
You need to update your httpd.conf to define the alias in Apache.
+
You will then need to activate the database changes etc.
 +
The 'official' way is to perform
   −
  [root@sme8 ~]# expand-template /etc/httpd/conf/httpd.conf
+
signal-event post-upgrade;  signal-event reboot
   −
Then restart Apache.
+
or if you do not want to restart your computer
   −
  [root@sme8 ~]# sv t /service/httpd-e-smith/
+
signal-event webapps-update
 +
</tab>
 +
</tabs>
   −
Initialise the Mysql template database
     −
  [root@sme8 ~]# expand-template /etc/e-smith/sql/init/phplistdb
+
There is no panel in the server-manager, you can go to https://sme-ip/lists/admin and login as SME Server admin and its password.
   −
Then execute the script.
+
==== Configuration ====
 +
{| class="wikitable"
 +
|+
 +
!db
 +
!key
 +
!property
 +
!default
 +
!accepted
 +
!information
 +
|-
 +
| rowspan="7" |configuration
 +
| rowspan="7" |phplist
 +
|status
 +
|enabled
 +
|<nowiki>enabled|disabled</nowiki>
 +
|
 +
|-
 +
|access
 +
|private
 +
|<nowiki>public|private</nowiki>
 +
|public for all web. private for local + httpd-admin ValidFrom
 +
|-
 +
|Authentication
 +
|http
 +
|<nowiki>http|</nowiki>
 +
|use http auth to login (broken)
 +
|-
 +
|AliasOnPrimary
 +
|enabled
 +
|<nowiki>enabled|disabled</nowiki>
 +
|create an alias lists. might disable if you use a dedicated domain using webapp virtualhost
 +
|-
 +
|AdminPass
 +
|
 +
|
 +
|password to access as primary "admin" to phplist
 +
|-
 +
|DbName
 +
|
 +
|
 +
|
 +
|-
 +
|DbUser
 +
|
 +
|
 +
|
 +
|}
   −
  [root@sme8 ~]# sh /etc/e-smith/sql/init/phplistdb
+
==== Administration ====
   −
In the last time, you need to set up the config.php of phplist.
+
To access the installation you have to go https://yourserver.tld/lists/admin. Use user admin with password
 +
config getprop  phplist AdminPass
   −
  [root@sme8 ~]# expand-template /usr/share/phplist/www/lists/config/config.php
+
You will then be able to configure your phplist organization, plugins and so on.
       +
The administrator interface is at https://yourserver.tld/lists/admin
   −
'''OR
+
The user interface is at https://yourserver.tld/lists
'''
  −
  [root@sme8 ~]# signal-event webapps-update
      +
you can also use the cli to set some elements
    +
phplist -pdbcheck
   −
=== Administrate ===
+
here is the list of options
 +
    initialise
 +
    dbcheck
 +
    send
 +
    processqueue
 +
    processbounces
 +
    import
 +
    upgrade
 +
    convertstats
 +
    reindex
 +
    blacklistemail
 +
    systemstats
 +
    converttoutf8
 +
    initlanguages
 +
    cron
 +
    updatetlds
 +
    export
 +
    runcommand
   −
Now you can access Phplist, you have just to go https://yourserver.tld/lists
+
==== Uninstall ====
 +
yum remove smeserver-phplist
 +
signal-event post-upgrade;  signal-event reboot
 +
==== Bugs ====
 +
Please raise bugs under the SME-Contribs section in {{BugzillaFileBug|product=|component=|title= bugzilla}}
 +
and select the {{#var:smecontribname}} component or use {{BugzillaFileBug|product=SME%20Contribs|component={{#var:smecontribname}}|title=this link}}
   −
The administrator interface was at https://yourserver.tld/lists/admin
+
Below is an overview of the current issues for this contrib:{{#bugzilla:columns=id,product,version,status,summary|sort=id|order=desc|component={{#var:smecontribname}} |noresultsmessage=No open bugs found.}}
   −
The last step is to populate the database.
+
===Changelog===
 +
Only released version in smecontrib are listed here.
   −
Go in the administation panel, and follow the Phplist instruction.
+
{{ #smechangelog: {{#var:smecontribname}} }}
    
[[Category:Contrib]]
 
[[Category:Contrib]]
 +
[[Category:Mail]]
 +
[[Category:Mail:Mailinglists]]
Super Admin, Wiki & Docs Team, Bureaucrats, Interface administrators, Administrators
3,250

edits

Navigation menu