FAQ & Troubleshooting | Helix Ultimate - Documentation | JoomShaper

Helix Ultimate

Updated Last: 09 December 2023

FAQ & Troubleshooting

No Offcanvas (Mobile) Menu after Helix update

 If after Helix Ultimate update to Helix Ultimate 2.0.14 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 icon after Helix Ultimate update

If after the Helix Ultimate update you don't see icons in dropdown menu or in 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 Custom CSS method (J4.4 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 {
  font-family: "Font Awesome 5 Free"; }

Make sure that you have enabled Font Awesome in Template Options.

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 will not help disable Mod Security for used domain inside cPanel.

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 Helix Ultimate QuickStart (helixultimate_quickstart_j4x.zip)
  2. Unzip the package and extract the needed and missing file: templates\helixultimate\webfonts\webfonts.json
  3. Use FTP to create the missing "webfonts" folder
  4. Then extract (1) and upload .json file from the package.

The same rules are for other templates, just use the proper template folder name.

Missing Language phrases in Helix after Joomla update

If you noticed that all language phrases have gone from Helix Template Options after the last 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 that language string "COM_FINDER_ADVANCED_TIPS".

No Language in Helix Template Options

You can fix it by using a new Template Helix Ultimate 2.0.18+ update >> https://www.joomshaper.com/joomla-templates?search=helix

If your template is not raw Helix Ultimate, but a template based on it. You have to take a language file (.ini) from Helix and use it inside language/en-GB folder, remember to rename it using your template, or

copy all content from the Helix language file: en-GB.tpl_shaper_helixultimate.ini and paste it into en-GB.tpl_YOUR-TEMPLATE-NAME.ini, for example, en-GB.tpl_investa.ini, en-GB.tpl_gourmand.ini, en-GB.tpl_innovate.ini etc. In case of using the original Helix language file remember to paste at the bottom those few lines:

HELIX_ULTIMATE_LICENSE_UPDATE="Update Settings"
HELIX_ULTIMATE_JOOMSHAPER_EMAIL="Email"
HELIX_ULTIMATE_JOOMSHAPER_EMAIL_DESC="Email address used in JoomShaper's user account."
HELIX_ULTIMATE_JOOMSHAPER_LICENSE_KEY="License Key"
J_TEXT_SHARE="Social Share"

How to hide Page Title

Page Title is from Helix features. You can customize 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.

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 Facebook article(s) don't have 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 do 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 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 nor favicon file inside Helix Ultimate, even 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 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 there upload your website logo then just choose inside template options.

I cannot upload images in Blog Options

If you changed the PHP version and after 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()

Makes sure that both the Helix Ultimate template and plugin were updated to the last version. hen 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.