FAQ & Troubleshooting | Helix Ultimate - Documentation | JoomShaper

Helix Ultimate

Updated Last: 12 April 2024

FAQ & Troubleshooting

No Offcanvas (Mobile) Menu after Helix update

 If after Helix Ultimate update to Helix Ultimate 2.0.18 on the front-end after clicking [=] icon you don't see Mobile Menu items but only darker (blurred) background - please follow those steps:

  1. Go to Templates > Helix Ultimate > Template Options > Menu > Offcanvas
  2. Then select one of the layouts. Must be a blue border around it (look at the screenshot below).
  3. Check if you selected the needed Menu inside "Select Off-canvas Menu".
  4. Click SAVE to set new settings. Now it should be fixed.
  5. If it's not yet, change Off-canvas Position (Left-Right or Right-Left), save settings, and then recheck.
Offcanvas menu select

If the above steps will not help - please watch the video guide: https://www.youtube.com/watch?v=OFgIgCB8e1Q

If still it doesn't help please use the Custom CSS fix:

.burger-icon > span {background-color: black; background: black;}
body.ltr.offcanvs-position-right.offcanvas-active .offcanvas-menu {background: white;}
.offcanvas-menu { background-color: white;}
.offcanvas-menu .offcanvas-inner ul.menu > li > a  {color: black;}

Remember to disable CSS compression before using Custom CSS. Then after using it, you can enable CSS compression, but clear Joomla and browser cache as well. If you use JCH Optimize or a similar tool, clear the cache inside it as well.

For more help use the Forum post.

If your header with logo and the off-canvas menu is too narrow - please change its height value using: Mobile view (icon on the top) with Header Height (Mobile) value. For example, use the value 60px. Then save template settings. If somehow it will not help in your case please use the Custom CSS method:

  @media (max-width: 680px) { 
 #sp-header {height: 60px;}
 }

Mobile (Offcanvas) Menu - items are not active

If you cannot click to open submenu items - probably you used the wrong Menu item type. Please do NOT use those (Separator nor Header) for main menu items (!). We recommend using the "URL" with "#" (hash) mark inside the URL field. Then your Mobile Offvancas Menu will work correctly, and you will be able to see and click (+) to open submenu items.

Mobile Offcanvas Menu - I cannot scroll down to see all the items

If you don't see all menu submenu items because you cannot scroll down probably you have to use extra custom CSS to fix it:

.offcanvas-menu {
    overflow-y: scroll;
}

How to center submenu (from Mega Menu) when is full-width alignment

As a temporary fix, please below the custom CSS code:

.sp-megamenu-parent {position: static;}

My MegaMenu bar is not centered anymore

If after Helix Ultimate update from 1.1x to 2.0 your Mega menu bar is not centered anymore, you have to use an extra CSS line:

#sp-menu > .sp-column.align-items-center { justify-content: center !important; }

MegaMenu without arrow icons for submenu items

If after the Helix Ultimate update, you don't see icons in the dropdown menu or off-canvas menu please follow the steps:

  1. Go to Template Options > Advanced (tab)> Font Settings > check if you have enabled Font Awesome (must be On).
  2. If you still don't see arrow icons check Advanced (tab) > SCSS > Compile SCSS to CSS: On > Save changes.
  3. If you have it On already, turn it OFF, Save changes, and Turn On > Save change
  4. Clear the Joomla cache after and reload the browser cache. 

In case of above method will not work, use the below Custom CSS  (for Joomla 5.0 only!):

.offcanvas-menu .offcanvas-inner ul.menu > li.menu-parent > a > .menu-toggler::after,
body.ltr .sp-megamenu-parent > li.sp-has-child > a::after, 
body.ltr .sp-megamenu-parent > li.sp-has-child > span::after,
body.ltr .sp-megamenu-parent .sp-dropdown .sp-dropdown-items .sp-has-child > a::after 
{font-family: "Font Awesome 6 Free"; }

For Joomla 4.4  use this Custom CSS:

.offcanvas-menu .offcanvas-inner ul.menu > li.menu-parent > a > .menu-toggler::after,
body.ltr .sp-megamenu-parent > li.sp-has-child > a::after, 
body.ltr .sp-megamenu-parent > li.sp-has-child > span::after,
body.ltr .sp-megamenu-parent .sp-dropdown .sp-dropdown-items .sp-has-child > a::after 
{font-family: "Font Awesome 5 Free"; }

I cannot save Template settings

If you cannot save changes in the Template Options area it may be caused by:

  • extensions conflict,
  • enabled Mod Security in cPanel,
  • enabled Rocket Loader script.

In that case, please disable all compression plugins and Cookie module and try saving again. If that will not help - disable Mod Security that is used domain inside cPanel. Ask hosting support if you cannot find that option. After adding & saving all changes you can turn on (enable) Mod_Security again.

If you need to disable the mod_security then alternatively you can use this code inside the .htaccess file (use it at the bottom):
<IfModule mod_security.c>
SecFilterEngine Off
SecFilterScanPOST Off
</IfModule>

Missing Webfonts.json File

If you installed only the template and you cannot choose any Google Font it means that the webfons.js file (with a list of fonts) was not uploaded.

Do not panic, easy to fix it:

  1. Download that file (zip)
  2. Unzip the package and extract the needed file: webfonts.json
  3. If you don't have - create the missing "webfonts" folder in the template folder:  templates\TEMPLATE-NAME\webfonts\
  4. Then using FTP or File Manager (cPanel) upload webfonts.json file inside "webfonts" folder.

folder webfonts

The same rules are for other templates, just use the proper template folder name. Even if you do not plan to use Google Fonts, that file should be there to hide that error message. This method will also be useful to update the font list without using the API key, for example, on localhost. Just override the current file with the new one, look at the tip below.

I cannot find the Google Font on the Font Selector list

In most cases, if you see a font on the Google Fonts website (fonts.google.com) but cannot find it on Font Selector inside Helix Template Options > Typography > Body/Heading - it means that your list of fonts wasn't updated. Hopefully, it's easy to correct/update in a few steps:

  1. Download that webfonts.zip file (March 2024)
  2. Unzip it.
  3. Run your FTP tool or use the File Manager component or File Manager from cPanel
  4. Upload & replace file here: templates\shaper_NAME\webfonts

Missing Language phrases in Helix after Joomla update

If you noticed that all language phrases have gone from Helix Template Options after Joomla update (4.4.1+, 5.0.1+) it means that you have to update the language file. The Joomla Team decided to make some changes to how Joomla reads & processes language files that why the old template language file may not work anymore. The issue is occurring because there are line breaks in the language string "COM_FINDER_ADVANCED_TIPS". You can remove them using Text Editor in a template language file. All paragraphs should be in one line.

No Language in Helix Template Options

If you have raw Helix Ultimate (but an older version) just install a new Template Helix Ultimate 2.0.18+ update >> https://www.joomshaper.com/joomla-templates?search=helix

If you renamed the template folder, take a new language file from the raw Helix Ultimate template package (en-GB.tpl_shaper_helixultimate.ini) and use content from it inside your renamed language .ini file.

If you have an Investa template - download the file, unzip the file, and then use the FTP tool to overwrite the current language file inside the language/en-GB folder.

If your template is based on Helix Ultimate (a premium template from JoomShaper) you have two alternative methods to fix the template language file from language/en-GB folder:

  1. edit template language file (.ini), find the string "COM_FINDER_ADVANCED_TIPS", and then using Text Editor remove space between paragraphs, all should be in one line. Save changes.
  2. OR you can just download this file, unzip it, and then:
    • check the unzipped folder, there are a few already fixed language files, you can use them if you recognize the name of the template you are using.
    • If not, then rename file en-GB.tpl_shaper_helixultimate.ini to be exactly the same as your template language file that you have
      in the language/en-GB folder  en-GB.tpl_YOUR-TEMPLATE-NAME.ini
    • As the final step use the FTP or File Manager (cPanel) to overwrite the current (.ini) file.
    • Remember that after those steps it will fixed for the English language only.

If your template was bought or downloaded from a different than the JoomShaper website - please contact its seller/developer or use the above tips at your own risk.

How to hide Page Title

Page Title is from Helix features. You can customize the title or hide it, all that can be done from Menu item settings:

Menus > Main Menu (in most cases) > Select the desired item -> Page Display (tab) -> change "Show Page Heading" to "Hide" or customize the title name.

Cannot Access Protected Property Joomla\CMS\Menu\MenuItem::$params

This problem is always from template code override, not from the Helix Ultimate plugin itself as you may think. Sometimes the template is old, created to work only for Joomla 3, and even if it may still display correctly on the front-end (in Joomla 4 or even Joomla 5) - but you won't be able to see and use MegaMenu. Starting by debugging the problem is to enable showing errors to maximum and enable debug mode.  Then you should be able to see which file causes the problem. If this is our template (purchases on the JoomShaper site) please use the forum post with our assistance. If the template doesn't belong to us (was made by somebody else), please contact the template developer & seller (Support Policy 8.8).

0 DateTime::__construct(): Failed to parse time string (-) at position 0 (-): Unexpected character

If your Helix Ultimate Template Options settings area crashed like in the below screenshot

HU2012-crash

The problem is caused by the wrong date format in the Coming Soon field. The correct schema is YYYY-MM-DD, like 2023-12-30, without exception even if you live in the USA.

YYYY-MM-DD

If you updated Helix already, to fix it you have two options:

  1. Reinstall with older Helix Ultimate 2.0.11 - go to Template Options > Basic > Enable Coming Soon > change date, and save settings, then you can install Helix Ultimate 2.0.12+ again.
  2. Or edit the Joomla database using PHPMyAdmin from cPanel -
  3. Go to table #_template_styles
  4. On column template - shaper_helixultimate  edit field the params  where you have to find the phrase "comingsoon_date" and the date numbers next to it. Remember that "-" must be between numbers. Correct the date format and save the changes! And it will be fixed.
date format

I cannot edit articles anymore, buttons are not active

If you updated the Helix template and have enabled Article or K2 Integration (SP Page Builder Pro)  and you have installed (preinstalled) J2Store (free/pro) and you don't see editor options inside the article (K2 item) anymore - it means that there is a conflict between jQuery UI.

not working buttons

To be sure it is it - check also if in the browser console there are the following errors:

jquery-ui.min.js:12 Uncaught TypeError: this._addClass is not a function
    at e.<computed>.<computed>._create (jquery-ui.min.js:12)
    at e.<computed>.<computed>._create (jquery-ui.min.js:16)

If yes, hopefully, it's very easy to fix it:

  1. Go to: Components - J2Store
  2. Then Setup - Configuration
  3. In Basic Settings - Load jQuery UI - set "Only frontend" or "No" (recommended).
  4. Then click "Save" or "Save & Close" to keep changes.
jQuery UI

If you don't use J2Store and you don't have an editor or editor toolbar - please make sure that you have chosen TinyMCE editor or JCE editor (updated) as your default editor in Global Configuration - check also your User settings.

0 count(): Argument #1 ($value) must be of type Countable|array, null given

Solution:  Go to this file location -> templates/template_name/html/mod_login/default.php and change from this
<?php if (count($twofactormethods) > 1) : ?>
to this
<?php if (count((array)$twofactormethods) > 1) : ?>

My custom CSS is not working

There are a few common causes for such issues in CSS.  And to be honest, in most cases, it's the webmaster's mistake. Perhaps somewhere higher in your CSS code, you made a mistake that affects the entire code that you add below. Sometimes missing closing "}" or/and opening "{" bracket may cause that. Missing a single closing bracket can throw off your entire website, because the browser quits loading your rules as soon as it encounters the malformed code. Typo errors are also important, for example, with=/=width (!). Invalid CSS format is one of the main causes of CSS not working.  Although you can use !important it can cause more problems further down.

Often the browser is very sensitive to these types of errors. First, check manually line by line. If still you cannot find it - there is an official CSS Validator, so you can copy the whole custom CSS that you have, paste it there, and check the results. Make suggested changes, and correct errors, typos, etc..

Since all templates and most extensions contain their own sets of styles, you will often find that your custom styles must “compete” against existing styles. In such situations, the more specific CSS selector will almost always win out over a less specific selector.

Another possible reason why CSS is not working is that you may have put the wrong class or ID name in the Custom CSS field or custom.css file. It won’t work since the browser is unable to match the name(s) to the class names used in the HTML code. Therefore, always make sure to check if the name of classes or IDs is entered correctly.

Often, browsers temporarily cache resources from sites you visit to enhance load speed. In some cases, Joomla websites use plugins/components for extra caching. So, sometimes you may not see custom styles on your site because the browser has cached your site’s old version or/and custom.css file. If clearing the browser cache does not rectify the issue, check this same site from the alternative browser. Also, you can rely on the private mode you get with some browsers like Chrome’s / Firefox's incognito window.

Do not feel bad if you make these silly mistakes. It happens to most of us, from time to time.

Shared in a Facebook article(s) don't have an image or have the old title

Both Helix Ultimate and SP Page Builder can add OG Tags that are added to the HTML code of the presented page, but indeed sometimes Facebook does not want to display it. In most cases, it's caused by a Facebook cache, not problems with JoomShaper products. Easy to make an investigation:

  1. Let's start with the source code of the page (with the article or page).Preview subpage using browser feature "View Page Source"
  2. Check the section between < head >  and < / head > and search for meta OG tags, if you find them - the code is OK.
  3. Now use FB Tool: https://developers.facebook.com/tools/debug/
    and put that URL there, and read what FB will tell you after analysis.
  4. In some cases, you have to click  "Scrape again" to reload the preview - if you saw old content without the current image/photo or title.
  5. If you made all the steps and it's OK - now during Article Share - all should be OK. If not blame FB, not us.

Com_sppagebuilder_media_manager_media_total_size_exceeds

If you cannot upload the website logo or favicon file inside Helix Ultimate, even if it's a very small (light) file. In that case please change PHP settings inside cPanel:

  1. in cPanel - MultiPHP INI Editor
  2. Memory_limit  and set 256M or 512M (recommended) -- then it will be fixed. Probably you have "-1" (no-limit) and that's why you have an upload problem.

If you have a different hosting panel - please ask hosting support how to set the above value.

A temporary solution: use Joomla Media Manager and upload your website logo then just choose inside template options.

I cannot upload images in Blog Options

If you changed the PHP version and you noticed that you cannot upload photos in Articles in the "Blog Option" tab anymore. Below is a screenshot from Joomla 4, but in Joomla 3.10 it looks very similar.

Guide: I cannot upload image

Please follow the steps to find a solution:

  1. First, in Joomla admin check: System Information > PHP Information > and search "memory_limit" - what is a value that you have? If you have "-1" (no-limit) please go to hosting cPanel or ask hosting support to change this value. We recommend using any value above 256M. For a typical small or middle website: 512M should be OK. Save changes and see if your value was updated. Then try to upload the image again.
  2. Try to upload a different image, maybe a smaller with.jpg an extension name. Are you able to see the uploaded image now?
  3. If still not, please disable all extra plugins that are used in Article editor mode. Then try again.

JUser: :_load: Could not load this user; user ID: XX

In general, it's a Joomla warning known to all J! webmasters since Joomla 1.x.  It means that the author of the article doesn't exist now. Here are some basic solutions that you can use to troubleshoot and resolve this issue:

  1. Edit each article and in Publishing (tab) > Created By > choose an author from the list of current users > Save & Close (repeat for others articles)
  2. Trash all demo articles that you don't need. Create your own articles.
  3. Create a new User (User Manager > New) - then using PHPMyAdmin in the prefix_users table change his ID from the current number to the number from the warning message.

Remember that any changes to your website should be performed carefully and with proper backups in place to avoid data loss (step 2). If you're unsure about 3rd step, it's better to seek assistance from someone with experience in the Joomla database.

Convert Forms: checkbox fields position is scattered

  If after adding checkbox fields you see something like in the below screenshot. Where label fields are far below the checkbox, not next to as supposed to be.

You have to add extra Custom CSS code to fix it.

.convertforms label {transform: none !important;}

 After using the above code inside Template Options - Custom Code - Custom CSS or inside custom.css file or inside Convert Forms forms settings you should get a fixed view.

Call to undefined method Joomla\CMS\Document\HtmlDocument::getWebAssetManager()

Make sure that both the Helix Ultimate template and plugin are updated to the latest version. Then check if the installed JCE Editor was updated, it should be v2.9.33+. In case of problems switch to TinyMCE editor to check the front-end article editor.