Install / Update issues

• Access Rights
• Install via FTP
• Blank page
• -1 - An error has occurred ( It was not possible to copy the selected file. )
• -1 - An error has occurred ( Copy failed )
• Unable to create target folder
• JFolder::create: Could not create directory - Unable to create destination
• Please enter a package directory - unable to find install package
• Failed to move file
• Component Install: DB function reports no errors...
• Error Building Admin Menus
• Frequently Asked Questions
  • Why don't you improve the install process instead of providing documentation?

Access Rights

AcyMailing installs files in the following folders. Please first make sure those folders are writeable before trying to install AcyMailing :

• Joomla / Administrator / Components
• Joomla / Components
• Joomla / Media
• Joomla / Modules
• Joomla / Plugins
• Joomla / Plugins / System
• Joomla / Language / en-GB
• Joomla / tmp

For the update process, please make sure the following folders are writeable:

• Joomla / Administrator / Components / com_acymailing
• Joomla / Components / com_acymailing
• Joomla / Media / com_acymailing
• Joomla / Modules / mod_acymailing
• Joomla / Plugins / acymailing
• Joomla / Plugins / System
• Joomla / Language / en-GB
• Joomla / tmp

Install via FTP

If you have difficulties to install AcyMailing, you may want to try to install it via FTP.
This way, Joomla won't have to upload the AcyMailing package on your website so the installation will be much faster.

• Extract your AcyMailing package in a folder called "acymailing" on your own computer.
• Open your FTP software (FileZilla for example), connect to your website and upload the folder "acymailing" in the temporary folder of your website : /tmp/
• Go to your Joomla Installer manager on your website backend and specify the path of your folder in the input "Install from Directory" : "\home\...\tmp\acymailing".
• Click on the button "Install"... the install process should be much faster and will enable you to successfully install AcyMailing.

Blank page

A blank page does not help us to determine what could be the problem so if you get a blank page (an entire white screen without anything written on it), please make sure that your PHP configuration enables you to see errors and if not, edit your php.ini file and search for the string parameter display_errors.
This parameter should be turned On : display_errors = On.
If it's not the case, please edit your php.ini file, modify this line, save your file and then restart your server and try again to install AcyMailing.
You should not see a blank screen any more and the error message will help us a lot to fix the problem.

You don't have access to your php.ini file?
Please add this code at the top of your index.php file (front-end or back-end... depending on where you have the blank page) on your website:

Show / hide php code

<?php error_reporting(E_ALL);
 ini_set("display_errors", 1); ?>

You can also turn ON the Joomla debug mode (Site -> Global Configuration -> System -> Debug System : Yes), it may display an error.

If you can not see any error, please try to install AcyMailing via FTP, it solves more than half of the installation issues.

-1 - an error has occurred ( It was not possible to copy the selected file. )

This error message is displayed when Joomla can not copy a folder from the temp folder to the destination folder.

It's usually because of access rights and you should make sure the AcyMailing folders are writeable (see above).

If it does not solve the issue, please edit the file libraries/joomla/filesystem/folder.php

Around line 93 AND 122, please replace:

Show / hide php code

return JError::raiseError(-1, JText::_('Copy failed'));

by

Show / hide php code

return JError::raiseError(-1, JText::_('Copy failed').'  '.$sfid.' => '.$dfid);

It won't solve the problem but at least if you try to install again AcyMailing, you will see a much better error message telling you what folder is not writeable.
That way you can move forward by fixing the permission issue on that folder and install again AcyMailing.

This kind of error can be automatically solved by enabling the FTP layer on the Joomla configuration page (or turning it OFF if it was enabled).

An error has occurred ( Copy failed )

Same error as above... And to check what's the issue, please edit the file libraries/joomla/filesystem/folder.php

Around line 98 AND 137, please replace:

Show / hide php code

return JError::raiseError(-1, JText::_('JLIB_FILESYSTEM_ERROR_COPY_FAILED'));

by

Show / hide php code

return JError::raiseError(-1, JText::_('JLIB_FILESYSTEM_ERROR_COPY_FAILED').'  '.$sfid.' => '.$dfid);

Then try to install again AcyMailing, you will see a more explicit error message and you can then change the access rights on the destination folder.

Unable to create the target folder

This error occurs if Joomla can not create a folder.

Please edit the file libraries/joomla/filesystem/folder.php
Around line 61 you should see:

Show / hide php code

return JError::raiseError(-1, JText::_('JLIB_FILESYSTEM_ERROR_FOLDER_CREATE'));

that you should replace by:

Show / hide php code

return JError::raiseError(-1, JText::_('JLIB_FILESYSTEM_ERROR_FOLDER_CREATE').' : '.$dest);

So next time you try to install Acy, you will get a better error message and you should check why the folder could not be created (usually an access right issue)

JFolder::create: Could not create directory
Unable to create destination
Unable to find install package

This error can occur if Joomla is not able to copy your package from your computer to your server.

It can be because you don't have enough rights on your tmp folder or because your tmp folder is not the right one.

Please edit the file libraries/joomla/filesystem/folder.php and around line 234 replace:

Show / hide php code

if (!$ret = @mkdir($path, $mode)) {
 @umask($origmask);
JError::raiseWarning(
 'SOME_ERROR_CODE',
 'JFolder::create: ' . JText::_('Could not create directory'),
 'Path: ' . $path
 );
return false;
 }

by:

Show / hide php code

if (!$ret = mkdir($path, $mode)) {
 umask($origmask);
 JError::raiseWarning(
 'SOME_ERROR_CODE',
 'JFolder::create: ' . JText::_('Could not create directory').' Path: ' . $path.' Your website is installed on: '.JPATH_SITE
 );
 return false;
 }

So unfortunately it won't fix the problem but if you reinstall AcyMailing, you will get a much better error message.

Please enter a package directory
Unable to find install package

This error can happen if you didn't enter a directory (or didn't enter the right one) if you try to install via the FTP method.

Modify the file administrator\components\com_installer\models\install.php

Around line 177 you should see:

Show / hide php code

if (!is_dir($p_dir)) {
 JError::raiseWarning('SOME_ERROR_CODE', JText::_('Please enter a package directory'));
 return false;
 }

Replace it by:

Show / hide php code

if (!is_dir($p_dir)) {
 JError::raiseWarning('SOME_ERROR_CODE', JText::_('Please enter a package directory').' | Example : '.JPATH_SITE.DS.'tmp');
 return false;
 }

Try to install again... you will get a better error message with the path you should normally use if you install via FTP.

This error may also occur on J2.5, you should edit the file administrator\components\com_installer\models\install.php

Around line 203 you should see:

Show / hide php code

if (!is_dir($p_dir)) {
 JError::raiseWarning('', JText::_('COM_INSTALLER_MSG_INSTALL_PLEASE_ENTER_A_PACKAGE_DIRECTORY'));
 return false;
 }

Which should be replaced by:

Show / hide php code

if (!is_dir($p_dir)) {
 JError::raiseWarning('', JText::_('COM_INSTALLER_MSG_INSTALL_PLEASE_ENTER_A_PACKAGE_DIRECTORY').' | Example : '.JPATH_SITE.DS.'tmp');
 return false;
 }

Warning! Failed to move file.

Modify the file libraries\joomla\filesystem\file.php

Around line 348, you will see:

Show / hide php code

JError::raiseWarning(21, JText::_('WARNFS_ERR02'));

Replace it by:

Show / hide php code

JError::raiseWarning(21, JText::_('WARNFS_ERR02').' FROM '.$src.' TO '.$dest);

Apply the exact same modification on line 358.

Then try to install again AcyMailing, you will still get an error message but at least you will know what folder is causing the issue so you can check the access right or make sure your tmp folder has the right path.

• Component Install: DB function reports no errors
• JFTP: :delete: Bad response
• JFTP: :delete: Bad response
• Error installing component

This error is apparently due to the fact AcyMailing could not be installed properly and there are probably still some instances of AcyMailing on your Extensions Manager.

Please go on your Extensions Manager (click on the menu "Manage"), select AcyMailing (the component) and uninstall it.

Once uninstalled, please access your phpMyAdmin and execute this query (don't forget to replace jos_ by your own table prefix):

• DELETE FROM `jos_menu` WHERE link LIKE '%com_acymailing%';
• DELETE FROM jos_extensions WHERE element = 'com_acymailing';
• DELETE FROM jos_assets WHERE name='com_acymailing';

Then install AcyMailing again... it should work.

Error Building Admin Menus

AcyMailing will be installed properly but then you won't be able to access it via the components menu on your Joomla back-end.

To fix that, you should uninstall AcyMailing via the Joomla Extensions manager.

Once uninstalled, please access your phpMyAdmin and execute this query (don't forget to replace jos_ by your own table prefix):

• DELETE FROM `jos_menu` WHERE link LIKE '%com_acymailing%';
• DELETE FROM jos_extensions WHERE element = 'com_acymailing';
• DELETE FROM jos_assets WHERE name='com_acymailing';

Then install AcyMailing again... it should work and you will new see AcyMailing under your component menu.