Frequently asked questions
- How to customize the subscription module?
- If sending fails, how can I continue?
- How to indentify problematic domains when sending process breaks or gets interrupted?
- Could not instantiate mail function
- The newsletter does not look like what I designed
- Images are blocked (red X)
- Newsletter is added to spam folder or not received
- FAQ: Not possible to subscribe in ccNewsletter new version update ?
- How to disable Bootstrap or jQuery in ccNewsletter
- Error notifications & what to do:
- When downloading, updating and installing components and/or receiving error notifications.
- FAQ: CORS error – (: CORS-aanvraag is niet gelukt)
- FAQ : IN3 payment method add in combination with Mollie
- FAQ : Error 404 View not found [name, type, prefix]: article, html, ccnewsletter View ?
How to customize the subscription module?
To customize the ccNewsletter subscription module, you will need to edit the HTML and CSS files (via FTP) in the below location (depending on your ccNewsletter version. Please note that we use the Bootstrap UI framework version 5.0x in our extensions in Joomla! 4 . (**Note: Joomla! 3 is on version 2.3.2 which is no longer supported) . You can use Bootstrap CSS classes to change the module styles. For example, changing the button from orange to green would mean finding the button HTML and changing “btn-warning” class to “btn-success”. You can use any of the available button classes to quickly create a styled button. Read more about Bootstrap buttons.
For Joomla! 3x:
After making your changes, use Joomla! template overrides (** Note: This is a archived page. The page contains information for an unsupported Joomla! version or is no longer relevant. It exists only as a historical reference, it will not be improved and its content may be incomplete and/or contain broken links.) to save your changes in your template! Starting with Joomla! 3.2 you can do all of this in the new Template Manager, read more.Select the file that matches the “Type of module effect” you selected in the administrator.There may be occasions where you would like to change the way a Joomla! Extension (such as a Component or Module, whether from the Joomla! core or produced by a third party) is displayed on your site. Of course, you could recode the Extension from scratch, but that may be a bit ambitious for you! Thankfully, there is another way.The standard output from any Joomla! Module or Component can be overridden by adding code to the html directory of your template. It is also possible to override two aspects of core functionality: Module chrome, and pagination. As of Joomla 3.2 , overrides can be created using the Template manager Creating Overrides
We have an example of the code needed to change all buttons to grey. You can copy and paste this to your template css (override) file. If you want another color than grey, search and replace #868d86 with your HEX color value.
If sending fails, how can I continue?
For ccNewsletter 3.0 and above : use the “Continue” button in the “Reports” view.
You are sending a newsletter to a “all subscribers” or a certain group, and for some reason ccNewsletter fails to send the newsletter to all subscribers. Maybe you closed the browser or your computer was shut down. The good news is that ccNewsletter has an inbuilt function, that will recognize this when you start sending the same newsletter to the same group. It will then continue where you left off and only send the newsletter to subscribers that did not already receive it.Please note that this only works when sending the same newsletter to the same group immediately after sending failed. For example sending newsletter A to group A, then resending newsletter A to group A. If you send newsletter A to group A, then newsletter A to group B or newsletter B to group A, all subscribers in that group will receive the newsletter. When sending to newsletter A to group A after that, all subscribers will also receive the newsletter again.
FAQ : Not all mails are send , what to do ?
This could be due to recent Joomla! Updates . Advisable is to check what this did to your current installations and what is new in both Joomla! And of course ccNewsletter . Check the Changelog and consult what recent updates might have done to you to your current installations customized or not. Do consult your data in the email addresses .
Example -> Check if the updates created errors in the syntax of the data in the email addresses that contained a first and last name. It could be that record was : firstname |lastname |emailadres.com ,and the email address first name;e-mailadres.com was output for these data records. That can generate an error.
How to indentify problematic domains when sending process breaks or gets interrupted?
If when sending newsletter the SMTP service interrupts with error, the sending process gets interrupted and it is difficult to indentify the problematic domains, in this case try to use standard Joomla! Debug & logging.
Screenshot : Debug plus Logging
Could not instantiate mail function
First, check that you have entered all details (From and From email) in the ccNewsletter configuration.
Second, ccNewsletter sends emails via whatever service you configured in the global configuration in Site > Global Configuration > Server. This error will be shown when an extension like ccNewsletter tries to send an email and it fails. If you are using PHPMail in the configuration (default in Joomla!) and it is not working, first try to send an email via another way in Joomla!. For example, dos your contact form work and send and email or does it also fail.
If both fail, contact your hoster provider and ask them why PHPMail is not working. You could also set the Joomla! configuration to SMTP.
The newsletter does not look like what I designed
Example problem: “When I send a real or test newsletter, the newsletter I or my subscribers receive is not at all like the one I created! In other words, the pictures and text in the “real” newsletter are not aligned at all like the way it is in the editor or the preview in ccNewsletter.”
Read about this in the Coding a newsletter section in the “Newsletters in ccNewsletter” chapter.
Images are blocked (red X)
If images that are not embedded in the newsletter but are retrieved from a server or external location, they can get blocked by the e-mail client. This is even a default functionality in Outlook and Windows Mail. Your users will have to find and select the “unblock” message or button in the e-mail client and click it so they can see all images.
In most e-mail clients the message will be something like these examples:
- Images are not displayed. – Display images below
- Images and other external content in HTML e-mail are blocked. Click here to show all images
This is not a ccNewsletter bug!
Newsletter is added to spam folder or not received
If your newsletter is marked as spam/junk or added to a spam/junk folder of Outlook, Thunderbird or Gmail, or isn’t received at all by users on for example Hotmail, Yahoo, Gmail; you should know this is a server and/or domain issue, not a ccNewsletter issue. The exact same newsletter might get into the same e-mails account inbox if it was sent from another server and/or domain.
Services like Yahoo, Gmail and Hotmail have their own “spam lists” where they add servers and domains that they think are sending spam or have sent spam in the past. So it is even possible to sent sent a newsletter from a server or domain which is NOT marked as spam in for example Gmail or Hotmail, but IS marked as spam in Yahoo “spam lists”. It is also possible the criteria of Yahoo/Gmail/Hotmail/Outlook etc. for spam were all met (for example: short message, bad server etc.) and that is the reason it got in the spam/junk folder.
To get a message in the e-mail account’s inbox:
- add more content to the message, rewrite the subject, delete bad HTML code and then see if it gets through
- send the newsletter from a server and/or domain which is not marked in the “spam lists”
FAQ: Not possible to subscribe in ccNewsletter new version update ?
Email-addresses already exist?
The code entered is wrong?
When clicking the button “subscribe” and appears that email-addresses cannot be un-subscribed from the newsletter list even though your list currently has no entry yet?
- Re-installation of the complete component
- Replacing the file “subscribe.js” from an working website into components/com_ccnewsletter/assets/js/subscribe.js
- Have Joomla 4 installed
- Have checked all the user rights and compared every configuration with the configuration of an working website
Still not possible?
Most likely this:
The table _subscribers has a wrong syntax.Investigate what workflow and/or what customization was used or done in the past , when/in collecting subscribers when sending your newsletters via ccNewsletter extension .Any custom adaptation done should be adjusted and dealt with. All customized entries if not adjusted will cause issues.
How to solve this?
Investigate your custom modifications you might have done in the past and address them accordingly. You could solve the problem by deleting the table newsletter_subscribers and re-installing ccNewsletter whereas the table can be created anew.
Note: Always create a backup before you update!We always advise creating a backup with Akeeba Backup. For any questions you might encounter when creating your backup see: www.akeeba.com/contact-us. Please note that when updating or upgrading all custom modifications you might have done will be lost. How to handle ? Consult above.
How to disable Bootstrap or jQuery in ccNewsletter
As of ccNewsletter 2.x and up, we implemented “Chill Creations Bootstrap” to load Bootstrap and jQuery in sites that do not load them already.
You can disable “Chill Creations Bootstrap” in the configuration of our extensions.
How to enable it? Go to https://getbootstrap.com/docs/5.2/layout/css-grid/
Not recommendable to still be on older version, but if you choose to be in older versions (** Note : no longer supported) -> Assuming that your template folder is called mytemplate, copy: media/akeeba_strapper/strapper.ini to templates/mytemplate/media/akeeba_strapper/strapper.ini
Then read the contents of strapper.ini to learn how to disable Bootstrap and/or jQuery. These settings will automatically apply to all extensions that use Akeeba Strapper, such as ccNewsletter, ccInvoices, CookieConfirm and all extensions from Akeeba.
Remember, when you upgrade the module in the future, your changes will be lost if you don’t back them up and re-apply.
Error notifications & what to do:
- Error notification : When saving entries error message received: Fatal error: Declaration of ccNewsletterControlleracknowledgement::save() must be compatible with Joomla\CMS\MVC\Controller\FormController::save($key = null, $urlVar = null)
Solution: Please update to ccNewsletter latest versions as of 3.0.5 + , PHP 8, Joomla! 4 +.
The save() function must have the same arguments as in the parent class. Joomla! 4 updated the parent class arguments. CccNewsletter also did so.
- Error notification: Deprecated : Function strftime() is deprecated in /home1 /Liverpool/public_html/libraries/scr/HTML/HTMLHelper.php on line 1076
This error appears because the version of Joomla is 4.2.8, for php 8.1 it should be at least 4.2.9. Joomla 4.2.8 also has a deprecated strftime() function in the Joomla core file (/libraries/scr/HTML/HTMLHelper.php on line 1076), so you need to update Joomla! to fix it . Errors appears because the version Joomla! 4.2.8, for PHP 8.1 it should be at least 4.2.9.
- Error notification :1366 Incorrect integer value -> Return to dashboard
Solution : Please update your extension accordingly.
What also not to do ?
- Do not change it manually
- Let ccInvoices do what ccinvoices is intended to do
- Error notification :Attempt to assign property :Return to dashboard
Solution : Please update your ccExtension accordingly.
- Error notification: : Error appears when connecting to Mollie : 500 Internal Server error message appears when in cciDEAL the button test payment is pressed
Error means there is something wrong on your server.
Check the logs to find the error.
Check your IP server number, then check your SMTP settings and adjust if you need to and if your sever changed IP number. If settings needs to be corrected, do so for correct PHP.
An IP # check & using correct SMTP settings for sending to correct PHP = error gone
- Error Notification: Status from Draft to Open remains Draft , invoice status or # does not change & invoice details are not saved successfully.
In the configuration “Invoice # start” it should be a number only, as it is [invoicenumber]. Anything else causes an error.
Wrong : “ID-[invoicenumber]-[mm][dd][yy”
Right : “123-[invoicenumber]-[mm][dd][yy”
Also: When changing the status from DRAFT to OPEN, a new ID is created that must be greater than the value of the “Invoice # start” field (and of course greater than the previous invoice ID).
The system will compare the new ID with the value input in the “Invoice # start” field. To avoid errors
- Change the value to 0
- Make sure the configuration is number only
- Do not use special characters
- Error: Attempt to assign property ” item_price_excl_tax on array “
Tax % : Re: ” item_price_excl_tax ” -> ” item _ tax _percentage : 0 ; ”
When adding a new item, and the field in the configuration is empty error can appear.
- When adding a new items, do check the “Possible tax values” if empty, if so do fill it in.
- Let ccInvoices do what ccinvoices is intended to do that is -> ‘The tax of the invoice will be shown in the total (ccInvoices will calculate this)’
If by any chance you want to, for any customized reasons, leave the field “Possible tax values” empty it will be ok if you have the extensions latest version.
- Error Not possible to install the newest version and warning appears ?
Warning: Metaregistrar: JScript Scripts are dangerous in email (88getPaymentStatus.js)
> Please logon to [filter.yourdomainprovider.net](http://filter.yourdomainprovider.net/ “”) to review the message with message id: 1pwIn2-000C55-Kh.
Above Warning appears when sending the ccExtension as an attachment.
Check your workflow and prior modifications. When updating to major versions you need to do a little investigation. Major releases almost always have large new features or changes which might impact your workflow or current installation and custom modifications . We advise reading the extensions changelog to see if these changes impact you in any way and do a little investigation first hand . Also : We always advise creating a backup with Akeeba Backup. For any questions you might encounter when creating your backup see: www.akeeba.com/contact-us. Please note that when updating or upgrading all custom modifications you might have done will be lost.
- Error 1146 Table ‘#.mlj3_virtuemart_payment_plg_virtuemart4ideal’ doesn’t exist
In the frontend the payment with ccIDEAL works.But in the backend the orders are not displayed when a user has ordered with certain payment methods. It comes to the above error visible.
What to do?
First of all are you on the right Virtuemart version in cciDEAL ? Because VM Payment information payment method name for V4 & V3 were changed and added in/as of Version 6.0.5 . For Virtuemart 3x is VM3 payment -cciDEAL integration & For Virtuemart 4x is VM4 payment – cciDEAL integration . Make sure you are. Due to the fact of not knowing in what circumstances this error might appear on thing is clear it is something in the VirtueMart.
What you can do to is the following : It can be fixed when you open the payment method in VM and saved it , this automatically creates the missing table and removes the error.
When downloading, updating and installing components and/or receiving error notifications.
When experience issues and receiving error notifications in following scenarios on
- Moving the site to a new hosting account, new server and not being able to get the extension .
- Updating seems to fail. Where/how to update?
- Help, I cannot download
- Is you Download ID correct ? And where to find it?
- Help, I cannot get component installed
- Moving old to new
Consult the following FAQ’s ->
FAQ: Is my download key correct? Do I have an active account? Where can I find my download key?
You can find the Download ID here (and please do also check that your subscription is active):
https://www.chillcreations.com/checkout/my-account/.Please make sure you have that Download ID set in the configuration for the extension. Your Download ID is NOT your subscription ID, order ID or Invoice ID!If that doesn’t work, please follow this troubleshooting doc, it just takes a few minutes. https://www.chillcreations.com/checkout/troubleshooting-extension-update-issues/
FAQ: Moving old to new
On the new site (the one that’s moved) we would delete the old ccExtension , and then download the latest ccExtension version from https://www.chillcreations.com/checkout/my-account/
After downloading it, install it in the new site. Check the API keys and if needed, add them.
After that, test .
FAQ : Where to find it all
The current version can be found in your site
Go to your site -> Component > extension
Scroll down to the footer and find the version in the gray area. If you see “ccExtension version & number” or higher there, you are using the latest version.
You should already have seen this update in Joomla Extension Manager (Site > Extensions > Manage > Update) if you have recently updated extensions on your site.
FAQ : If you don’t have this version and don’t see the update in the Extension Manager.
There may be something wrong with the updater on your site.
FAQ: Where to find the download key?
Your download ID is to be found in your account chillcreations.com > My Account.
FAQ : Where to get the downloads from?
If you have a new subscription, purchased , get the downloads from:
If you have an active subscription get the downloads from the old downloads system:
View the changeling for all extensions here:
FAQ : When experiencing errors when installing components.
When you are experiencing issues installing an ccExtension component but no issues downloading the component ( in this case as an example ccInvoices ) the advise is to:
- Joomla! 4, PHP 8 and MYSQL 8
- Check if it is a fresh install of Joomla! 4, if not, it is advisable to install a fresh version of Joomla! 4.
- Address any other errors (other components ) which are present on the site.
- See if it is an upgraded version form Joomla! 3 and other components have a “Class ‘JRequest’ not found” error
- Check if JRequest was completely removed form Joomla! 4
- If old site is moved to a new server
During our testing cases, when installing a fresh version of Joomla! 4 in our test environments, we do not experience any errors when installing our components . Our advice is address issues found and install a fresh version.(Always make sure you created an Akeeba backup!)
FAQ : When moving form old to new server and receiving error notifications!
Receiving error notification can mean that there is something wrong on your server .
Check the logs to find the error.Check your IP server number, then check your SMTP settings and adjust if you need to and if your sever changed IP number. If settings needs to be corrected, do so for correct PHP. In brief:
An IP # check & using correct SMTP settings for sending to correct PHP = error gone
FAQ: ccExtension module suddenly disappeared when installing & transferring content to Joomla! 4?
Check your trash bin, when editing and changing stuff you might have removed it. Find and reactivate .
FAQ : Not possible to install the newest version and warning appears?
Warning being : Metaregistrar: JScript Scripts are dangerous in email (88getPaymentStatus.js)
When updating to major versions you need to do a little investigation. Major releases almost always have large new features or changes which might impact your workflow or current installation and custom modifications . We advise reading the extensions changelog to see if these changes impact you in any way and do a little investigation first hand.
Also : We always advise creating a backup with Akeeba Backup. For any questions you might encounter when creating your backup see: www.akeeba.com/contact-us. Please note that when updating or upgrading all custom modifications you might have done will be lost.
Above Warning appears when sending the ccExtension as an attachment.
Check your workflow and prior modifications.
FAQ: CORS error – (: CORS-aanvraag is niet gelukt)
A common cause of a CORS error is an `http` to `https` request or vice versa. It is not related to ccExtensions. It is more like a server/hosting issue.
Do consult with your hosting/server and explain where this error appears.
FAQ : IN3 payment method add in combination with Mollie
Available since versions ccNewsletter 3.0.8, cciDEAL 6.0.11, ccInvoices 4.0.8, IN3 payment method in combination with Mollie.
IN3 lets customers make payments in 3 interest-free instalments over 60 days. With Mollie and in3, your customers can use their preferred payment method, iDEAL, to buy now and pay later. Currently in3 is only available to consumers residing in The Netherlands.
For any support concerning plugin IN3, do consult IN3 plugin support.
FAQ : Error 404 View not found [name, type, prefix]: article, html, ccnewsletter View ?
Register for a group, you experience an issue that the second step of registering for the groups doesn’t work. Instead, subscribers receive the 404 page ?
When form is filled and is send to test , error 404 is received ?
- “group not editable” means you can’t edit any group because it doesn’t save but creates a new one, so you can’t, for example, change the name of the group. But it doesn’t show any errors.
- There were changes to the ccNewsletter modules template that fixed this for Joomla 4, but if you have these templates overridden in the theme with an older version, you will have to fix this.
To fix this, at least this template file ‘modules/mod_ccnewsletter/tmpl/.dropdown.php’ should be merged with ‘templates/yootheme/html/mod_ccnewsletter/dropdown.php’.