Changes

Jump to navigation Jump to search
2,232 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]<br />
      
[mailto:daniel@firewall-services.com[[User:VIP-ire|Daniel 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 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.
+
[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.
    
=== Requirements ===
 
=== Requirements ===
 
You need the [[Fws|firewall-services]] repo to install this contribs
 
You need the [[Fws|firewall-services]] repo to install this contribs
   −
=== Installation 8.x 9.x===
+
=== 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.}}
 +
 
 
This contrib is currently held in the fws repository, so the following commands will install on your smeserver.
 
This contrib is currently held in the fws repository, so the following commands will install on your smeserver.
   Line 25: Line 53:     
  signal-event webapps-update
 
  signal-event webapps-update
 +
</tab>
 +
</tabs>
   −
There is no panel in the server-manager, you can go to https://sme-ip/phplist/admin and perform a login with admin and its passwords of your internal ldap.
      +
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.
   −
==== Administrate ====
+
==== 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
 +
|
 +
|
 +
|
 +
|}
   −
Now you can access Phplist, you have just to go https://yourserver.tld/lists
+
==== Administration ====
   −
The administrator interface was at https://yourserver.tld/lists/admin
+
To access the installation you have to go https://yourserver.tld/lists/admin. Use user admin with password
 +
config getprop  phplist AdminPass
   −
The last step is to populate the database.
+
You will then be able to configure your phplist organization, plugins and so on.
   −
Go in the administation panel, and follow the Phplist instruction. set the first admin account and now you need to fill in all mandatory fields.
     −
=== DB commands ===
+
The administrator interface is at https://yourserver.tld/lists/admin
   −
==== The bounces account ====
+
The user interface is at https://yourserver.tld/lists
   −
We need, to have Phplist working well, to create an account "bounces@youdomain.tld".
+
you can also use the cli to set some elements
   −
We have to setup a password for this account.
+
phplist -pdbcheck
   −
To configure the Bounces account in Phplist :
+
here is the list of options
 +
    initialise
 +
    dbcheck
 +
    send
 +
    processqueue
 +
    processbounces
 +
    import
 +
    upgrade
 +
    convertstats
 +
    reindex
 +
    blacklistemail
 +
    systemstats
 +
    converttoutf8
 +
    initlanguages
 +
    cron
 +
    updatetlds
 +
    export
 +
    runcommand
   −
  [root@sme8 ~]# db configuration setprop phplist BouncesPassword the_password
+
==== Uninstall ====
  [root@sme8 ~]# signal-event webapps-update
+
yum remove smeserver-phplist
 
+
signal-event post-upgrade;  signal-event reboot
==== Access to the Administrator Panel ====
+
==== Bugs ====
 
+
Please raise bugs under the SME-Contribs section in {{BugzillaFileBug|product=|component=|title= bugzilla}}
By default, only '''admin''' user can access to the administrotor panel.
+
and select the {{#var:smecontribname}} component or use {{BugzillaFileBug|product=SME%20Contribs|component={{#var:smecontribname}}|title=this link}}
 
  −
To add new users, you can add login in the DB :
  −
 
  −
  [root@sme8 ~]# db configuration setprop phplist AdminUsers user1,user2,user3,fws,admin
  −
  [root@sme8 ~]# signal-event webapps-update
      +
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.}}
    +
===Changelog===
 +
Only released version in smecontrib are listed here.
    +
{{ #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