This manual applies to AfterLogic WebMail Lite PHP (referenced in this document as WebMail).
To integrate WebMail into cPanel, you need to install WebMail on cPanel server and edit a few cPanel scripts.
Files related to cPanel integration are located in webmail/cpanel_integration folders inside WebMail installation package.
List of files and short description of each (in webmail folder of WebMail):
Install AfterLogic WebMail into /usr/local/cpanel/base/wm/ folder. Installation instructions are available here.
After installation complete your /usr/local/cpanel/base/wm/ folder should have the following content:
Do not forget to set read/write permissions for all users (777) for /usr/local/cpanel/base/wm/data/ folder and all its subfolders and set apache.apache as the owner of /usr/local/cpanel/base/wm/data folder and all its contents.
In order to embed AfterLogic WebMail into cPanel webmail screen, we need to modify cPanel's skins. Some files to be modified may be write-protected. In this case you need to run the following command on each file in need to be modified:
chattr -i <filename>
AfterLogic WebMail can be added to list of available webmails in two ways:
What type of installation to choose – is completely up to you.
Let's make integration with x3 skin (default in cPanel 11).
cd /usr/local/cpanel/base/webmail/x3
cp index.html index.bak.html
<div align="center"> <table align=center width="700" border="0"> <tr align="center">
Let's make integration with x3 skin (default in cPanel 11).
cd /usr/local/cpanel/base/webmail/x3
cp index.html index.bak.html
Let's make integration with x skin
cd /usr/local/cpanel/base/webmail/x
cp index.html index.bak.html
<div align="center"> <table align=center width="700" border="0"> <tr align="center">
Let's make integration with x skin
cd /usr/local/cpanel/base/webmail/x
cp index.html index.bak.html
Let's make integration with x skin front-end part
cd /usr/local/cpanel/base/frontend/x
cp webmaillogin.html webmaillogin.bak.html
<table align=center width="600" border="0"> <tr align="center">
Let's make integration with x skin front-end part
cd /usr/local/cpanel/base/frontend/x
cp webmaillogin.html webmaillogin.bak.html
Do not forget to change attributes back for all files that were modified before
chattr +i <file name>
We are almost done. Now you can visit
http://your.domain.name/webmail/
in order to see cPanel webmail selection screen presented on the following screen:
AutoLoad feature works too so that you can set AfterLogic WebMail as the default webmail.
If you want to use another cPanel skin, you need to adapt the patch to fit another layout.
To access AdminPanel, type the URL of AfterLogic WebMail and add /adminpanel. For instance:
http://www.mydomain.com:2095/wm/adminpanel/
Because cPanel may use different port and URL mappings in various configurations, it’s often easier to navigate to http://your.domain.name/webmail/ and then log in AfterLogic WebMail to learn its URL. Now, you can append /adminpanel to that URL to get into AdminPanel.