logo

How to migrate ccNewsletter from Joomla! 3.x to 4.x

Important notifications :

Note 1: Support for PHP 7 has ended November 28, 2022.
https://magazine.joomla.org/all-issues/december-2022/upgrading-your-site-to-php-8
Note 2: Support for Joomla 3x scheduled end is August 17, 2023. We strongly advise to migrate to Joomla 4 before that time to continue being supported.

Note 3: VirtueMart -> We strongly advised to use only VM3 + J3 or VM4 + J4 or J3 ( We do NOT recommend VM3 on J4)
Note 4: As is the case with all minor or major extensions updates, we always advise creating a backup with Akeeba Backup first.

Note 5: (Needless to say, but doing so anyway)  Support for these versions of Joomla! (2.5 & 1.7, 1.6 ) ended on respectively between December 31, 2012 and December 31, 2014. Still on those ? Do plan to move to Joomla! 4x.

Be aware that Joomla 3.10 will continue to be supported until August 17, 2023, although as its now over + 21 months since the release of Joomla 3.10 and 4.0 , Joomla 3 will only get security releases until ending. Our extensions are backward compatible with Joomla! 3x but support will also end August 2023 . Joomla 3x and PHP 8 are not well together and you should be planning or be in the process of migrating to the latest version of Joomla.

Joomla! provides resources to help with the migration on their documentation site https://www.joomla.org/ . For ccExtensions do read further & use FAQ’s.

Yes! It is possible to migrate ccNewsletter information (subscribers, newsletters etc) from Joomla! 3.x. to Joomla! 4.x.

We have different migration manuals for this extension:

It is very important that you install the correct version of ccNewsletter in both sites!

Method 1: moving the database/files during migration

  • On the Joomla! 3.x website:
    • Create a backup of the Joomla! 3.x website (with Akeeba Backup)
    • Make sure you are using the latest version of Joomla! 3.x
    • Make sure you are using the latest ccNewsletter version that supports Joomla! 3.x
    • Use your favorite extension to migrate your Joomla! 3.x website (SP Upgrade) and in that extension make sure to enable the option to also move ccNewsletter’s database tables. SP Upgrade has this option, ask the extension developer if you can not find it. This will allow the extension to also “move” the ccNewsletter information to the new Joomla! 3.x website
  • On the Joomla! 4.x website:
    • After the migration it should be enough to install the ccNewsletter version you had installed on Joomla! 3.x in your Joomla! 4.x website, after which ccNewsletter will recognize the database tables and work again
    • Do a full check of ccNewsletter to make sure everything works, for example check newsletters, subscribers, the subscription module (if used), menu items and configuration. It might be easy to just go through the ccNewsletter manual and and use that as a reference
    • It is now possible to update ccNewsletter to the latest version we have available for Joomla! 4.x

For any questions you might encounter when creating your backup see: www.akeeba.com/contact-us. Do also consult FAQ’s When downloading, updating and installing components and receiving error notifications.

Method 2: moving the database/files after migration

For this method, experience with PHPMyAdmin (or similar) is required

  • On the Joomla! 3.x website:
    • Create a backup of the Joomla! 3.x website (with Akeeba Backup)
    • Make sure you are using the latest version of Joomla! 3.x
    • Make sure you are using the latest ccNewsletter version that supports Joomla! 3.x
    • Login to the MySQL database of the Joomla! 3.x website, on most hosters you can use PHPMyAdmin to reach the database, ask your hoster for details
    • Find the ccNewsletter tables, they start with #__ccnewsletter__XXXX where #_ is a random prefix and XXXX is the table name (for example: jos_ccnewsletter_subscribers)
    • Select all ccNewsletter tables, and export them with PHPMyAdmin
  • On the Joomla! 4.x website:
    • Login to the MySQL database of the Joomla! 4.x website
    • Import the tables you just exported into PHPMyAdmin
    • After the import it should be enough to install the same ccNewsletter version you had on Joomla! 3.x on your Joomla! 4.x website, after which ccNewsletter will recognize the database
      tables and work again
    • Do a full check of ccNewsletter to make sure everything works, for example check newsletters, subscribers, the subscription module (if used), menu items and configuration. It might be easy to just go through the ccNewsletter manual and and use that as a reference
    • It is now possible to update ccNewsletter to the latest version we have available for Joomla! 4.x

For any questions you might encounter when creating your backup see: www.akeeba.com/contact-us. Do also consult FAQ’s When downloading, updating and installing components and receiving error notifications.

Just a friendly note:
(SP Upgrade):

In the old Joomla! 1.5 when you wanted to transfer database items to a different Joomla, just an export/import of the required database tables would do the job. With the new Joomla! 1.6, 1.7, 2.5, 3.x, 4.x and above, this is no longer possible.

SP Ugrade tool is very handy to transfer database items to an different Joomla and is also suitable for upgrading Joomla! 3.x to  4.x. Joomla version 3.x and 4.x supported, refers to all releases of Joomla 3 and 4.