During the installation, Acajoom will create folders and add files in the following folders :  

• Joomla / Administrator / Components /
• Joomla / Components / 
• Joomla / Modules /
• Joomla / Plugins /  (only if you use Joomla 1.5)
• Joomla / Mambots /  (only if you use Joomla 1.0)

Those folders must be writeable otherwise Acajoom won't be able to install the component or finish properly the install process.

• Error adding bot directory
• Acajoom Module : Error creating folder
• ERROR : Could not find an XML setup file in the package
• Blank screen
• Memory limit
• SQL Error : Illegal mix of collation
• open_basedir restrictions
• You are not authorized...

Error adding bot directory

Error message

Acajoom Plugin (Bot) :
Error adding bot directory.
Error copying bot file acajoombot.php to bot directory.
Error copying bot file acajoombot.xml to bot directory.
Error copying bot file index.html to bot directory...

Solution

Acajoom didn't have enough permissions to install the Acajoom Plugin. In this case, the Acajoom component is probably already installed so the easiest way to complete the installation is to download the Acajoom Plugin (or the Acajoom Mambot if you use Joomla 1.0.x) and install it separately using the Joomla installer.

 

Acajoom Module : Error creating folder 

Error message

Acajoom Module : Error creating folder : /xxx/xxx/xxx/modules/mod_acajoom/
Error copying module file mod_acajoom.php to module directory ...

 

Solution

Acajoom didn't have enough permissions to install the Acajoom Module. In this case, the Acajoom component is probably already installed so the easiest way to complete the installation is to download the Acajoom Module and install it separately using the Joomla installer.

 

ERROR : Could not find an XML setup file in the package 

Error message 

Upload component - Upload Failed
ERROR: Could not find an XML setup file in the package.
Upload component - Failed
Installation file not found: ...

Solution 

This error can appear if your folders don't have the right permissions and don't allow Acajoom to add files.
Set the correct permissions on the folders written at the top of this article and try to install the package again.

If you still have the same error message, turn OFF the safe_mode on your server : open your php.ini file and seach for the string safe_mode.
You should find the line : safe_mode = On
Replace it by : safe_mode = Off
Restart your server, make sure you deleted all files created by Acajoom and try to install it again.  After that, you can change back your php.ini file.

 

Blank screen

Error message

Solution 

You should turn ON the Debug mode in Joomla, uninstall the Acajoom component with the Joomla installer, delete all the files and folders created by Acajoom and try again to install the package.  You should see an error this time.

 

Memory limit 

Error message

Fatal error: Allowed memory size of 8388608 bytes exhausted (tried to allocate 77824 bytes) in ...

 

Solution 

Your configuration on your server doesn't allow enough memory for Acajoom. To fix that, you have to increase this limitation. Edit your file "php.ini" on your server and change the value of "memory_limit" from 8M to 64M. Make sure you edited the right "php.ini" file and restart your server (you can have two php.ini files on your server). Delete all the Acajoom folders created and try to re-install Acajoom.

If this first solution doesn't work and you still have the same error message, you can add the code ini_set('memory_limit','64M'); in the file "configuration.php" of your Joomla installation.

SQL Error : Illegal mix of collation

Error message

"Illegal mix of collations (latin1_swedish_ci,IMPLICIT) and (latin1_general_ci,IMPLICIT) for operation..."

Solution

If you see this kind of error, that means there's two different collations in your database. When Acajoom synchronises the subscribers and the Joomla users, the program executes a query and compare fields (like e-mail, name...) so both tables "jos_users" and "jos_acajoom_subscribers" must have the same collation. To solve it, you have to change the collation of Acajoom's tables.

 

To change this, you can use the following SQL queries (in our example, we change the collation to "latin1_general_ci" but you have to take the same value than the field "email" from the "jos_usersé table to make sure that will work) :

ALTER TABLE `jos_acajoom_subscribers` CHANGE `name` `name` VARCHAR( 64 ) CHARACTER SET latin1 COLLATE latin1_general_ci NOT NULL;

ALTER TABLE `jos_acajoom_subscribers` CHANGE `email` `email` VARCHAR( 100 ) CHARACTER SET latin1 COLLATE latin1_general_ci NOT NULL;

If you use PHPMyAdmin, go into your database.

Click on the tab SQL.

Copy and past the SQL queries and click on the button Go. 

 

Or you can also do that with the phpMyAdmin interface :

1/ Check your default collation for Joomla tables : Select the table "jos_users" and you will see all the fields. You can see a columns called "Collation". Write somewhere the value of this column for the field "email", this is the collation used by Joomla.

2/ Click on the table "jos_acajoom_subscribers" and edit the fields "email" and "name" to change the collation to the same you previously wrote.

open_basedir restrictions

Error message

If you get this kind of message :

JFolder::create: Infinite loop detected

Warning! - Failed to move file

or :

Warning: file_exists() [function.file-exists]: open_basedir restriction in effect

or :

Unable to find install package

Solution 

There's a problem with the configuration of php.
If you've access to your php.ini, please comment the line open_basedir (Just add ; at the beginning of the line) and restart your Apache server.

Otherwise, open the configuration.php and add this line at the beginning :
ini_set('open_basedir', NULL);

Verify that the required directories are writable. You can see it by going to the menu :

• With Joomla 1.0.x : System > System Info; Click on the tab Permissions
• With Joomla 1.5.x : Help > System Info; Click on the tab Directory Permissions

You are not authorized...

Error message

When you try to see the archive via the front you get this kind of error :

You are not autorized...You must log in

Solution

It seems you have a menu with the Itemid=99 and with restricted rights. This blocks the Acajoom module. So, when your subscribers try to have access to Acajoom module, they are redirected to a page for the unauthorized access.

You can try to have access to the Acajoom module with an other Itemid such as 999 for example.

First, try with this url :

http://<your_joomla>/index.php?option=com_acajoom&Itemid=99

And then, with this one :

http://<your_joomla>/index.php?option=com_acajoom&Itemid=999

To solve it to the long term, you have to change the Itemid to 999. All new newsletters will have the Itemid=999

To change it, go to the menu Components > Acajoom > Configuration.  Click on the tab Miscellaneous.

If your subscribers want to unsubscribe to an old newsletter, you have to find the menu with the Itemid=99 and set to a public access. It's the short term solution before the long term solution.