Update Guide
Update%20Guide
Update%20Guide
User Manual: Pdf
Open the PDF directly: View PDF  .
.
Page Count: 47
| Download |  | 
| Open PDF In Browser | View PDF | 
ultimo
Update Guide
Copyright © Infortis. All rights reserved.
1
Table of Contents
1. Important changes.......................................................................3
1.1 General guidelines.......................................................................................................................................3
1.2 Ultimo version 1.17.0....................................................................................................................................3
1.3 Ultimo version 1.16.0....................................................................................................................................4
1.4 Ultimo version 1.15.4.....................................................................................................................................9
1.5 Ultimo version 1.15.0...................................................................................................................................10
1.6 Ultimo version 1.14.0...................................................................................................................................14
1.7 Ultimo version 1.13.0...................................................................................................................................14
1.8 Ultimo version 1.12.0...................................................................................................................................15
1.9 Ultimo version 1.11.1.....................................................................................................................................17
1.10 Ultimo version 1.11.0..................................................................................................................................18
1.11 Ultimo version 1.10.4..................................................................................................................................18
1.12 Ultimo version 1.10.3.................................................................................................................................18
1.13 Ultimo version 1.10.2.................................................................................................................................19
1.14 Ultimo version 1.10.0................................................................................................................................20
1.15 Ultimo versions 1.9.0 - 1.9.4....................................................................................................................24
1.16 Ultimo version 1.8.0..................................................................................................................................29
1.17 Ultimo version 1.7.1...................................................................................................................................29
1.18 Ultimo version 1.7.0..................................................................................................................................29
1.19 Ultimo version 1.6.0...................................................................................................................................31
1.20 Ultimo version 1.5.10................................................................................................................................34
1.21 Ultimo version 1.5.6..................................................................................................................................35
1.22 Ultimo version 1.5.3.................................................................................................................................36
1.23 Ultimo version 1.5.0.................................................................................................................................37
1.24 Ultimo version 1.4.0.................................................................................................................................39
1.25 Ultimo version 1.3.1..................................................................................................................................39
1.26 Ultimo version 1.3.0.................................................................................................................................40
2. Upgrade procedure....................................................................41
2.1 Prepare your Magento..............................................................................................................................41
2.2 Upload files.................................................................................................................................................43
2.3 Import sample blocks and pages.........................................................................................................45
2.4 Problems after upgrade..........................................................................................................................46
2
1. Important changes
Here you can find description of the most important changes in selected versions. List of
all changes in all versions can be found in Changelog.txt in the download package.
You can upgrade directly to the latest version (and omit all versions between) but you need
to follow all the instructions provided for each version which you want to skip.
1.1 General guidelines
a) Re-save theme settings after upgrade
To get rid of the old outdated CSS generated automatically by the theme (the old CSS may
break the layout after you upload new version of the theme), re-save settings after
upgrade. Go to System > Configuration > Ultimo > Theme Design and click Save
Config button. Then go to System > Configuration > Ultimo > Theme Layout and
click Save Config button again.
b) Review and update your sub-theme
This is extremely important step. If you’re using sub-theme, review your modified files to
make sure they don’t override new features added to the theme.
c) Review and update your CSS
Review your CSS modifications in custom.css to check if they don’t break any new
styles added to the theme.
1.2 Ultimo version 1.17.0
This release includes numerous enhancements and several functional fixes. The most
important changes are described below. A complete list of changes, as always, can be
found in the Changelog.txt file in the theme package.
3
Bootstrap grid
We have added an option to enable the grid system from Bootstrap (version 3.3.7). Note
that this is not full Bootstrap library, but our custom build of Bootstrap – only these
components were compiled: "Grid system" (grid.less) and "Responsive utilities"
(responsive-utilities.less).
The grid system is enabled by default, but if you need, it can be easily disabled under
System > Configuration > Theme Settings > Integrations.
Option to disable the grid is useful if you already customized your Magento and added this
version of Bootstrap (including the grid system) to the frontend of your store. In that case
you may want to disable this option in Ultimo theme.
Details about the grid system and utility classes can be found in the User Guide in
chapters:
◦ 6.4 Grid system
◦ 6.5.1.A Hide/show content depending on screen size
1.3 Ultimo version 1.16.0
In this update we have rewritten and reorganized large parts of the code. The changes
we've made will let us implement new features and make updates in shorter time. Most
important changes are described below. As always, the list of all changes can be found in
the Changelog.txt file in the theme package.
To update the theme in your Magento correctly and to avoid problems with partial update
(when some files were updated and some files are still outdated) we recommend to
remove all the old Ultimo files and folders from your system and replace them with
the new files and folders of Ultimo 1.16.0.
Important:
remember to backup your customized files. And more importantly, remember
to update your customized files (e.g. when you created custom sub-theme).
Otherwise your customized and outdated files will cause errors (difficult to
debug) and conflicts with the new files and the theme will not work correctly.
4
JavaScript
Added jQuery UI
We have added jQuery UI library. It is custom build (version 1.11.4) which contains only
the Widget component.
jQuery update
We have updated jQuery library to version 1.12.4. Here's the location of the new file:
js/infortis/jquery/jquery.min.js
Note that jQuery is added to the frontend in the layout files of all modules. In Ultimo 1.16.0
the name of the file with jQuery has changed so also the layout files were modified.
So if you override any of these files in your custom sub-theme, you will need to update
your customized files. Otherwise you may have JavaScript conflicts on the frontend.
The modified layout files are located in this folder:
app/design/frontend/ultimo/default/layout/
Here's the list of these files:
•
local.xml
•
infortis_brands.xml
•
infortis_cloudzoom.xml
•
infortis_ultramegamenu.xml
•
infortis_ultraslideshow.xml
Menu
We have rewritten menu scripts and large parts of the HTML and CSS. We have also
reorganized and simplified menu configuration options in the admin panel (under System
> Configuration > Menu).
Top menu
The top menu can be displayed in two layouts:
•
horizontal menu – standard dropdown menu, it is the default layout, it was
5
available in previous versions.
•
vertical menu – categories are stacked vertically inside a dropdown box which can
be shown/hidden when user clicks the button inside the menu bar. Subcategories
are displayed in dropdowns at the right side of the main dropdown.
Sidebar menu
The sidebar menu can be displayed in two layouts:
•
sidebar accordion menu – simple accordion, it's the same layout which was
available in previous versions.
•
sidebar mega menu – sidebar mega menu can display dropdowns in a similar way
to the top menu (when it has "vertical menu" layout enabled). Categories are
stacked vertically and subcategories are displayed in dropdowns at the right side of
the menu.
In sidebar mega menu the dropdowns can be styled the same way as in the top
menu.
There are also new design settings for the sidebar menu under System >
Configuration > Theme Design > Main Menu.
Dropdown boxes
There are new options for dropdowns of the top menu:
•
dropdown aligned with selected container – the right edge of the dropdown can
be automatically aligned with the selected container if the edge sticks out further to
the right than the selected container.
•
full-width dropdown as wide as selected container – full-width dropdowns can
be as wide as the selected container.
If a dropdown box of a top-level category was set as full-width (i.e in category
settings the Submenu Type field was set to Mega drop-down and the Drop-down
Width field was left empty), it will be as wide as the selected container.
So the width of dropdowns does not depend on the width of the menu bar any more
– this gives you more flexibility in configuration.
Both options can be found under System > Configuration > Menu > Additional
Settings.
6
Header
We have rewritten header scripts and large parts of the HTML and CSS. There are several
new settings such as new color settings for mobile header.
Sticky logo
There is also a new option to display logo image in the sticky header.
To display sticky logo:
1. Enable sticky logo under System > Configuration > Theme Settings >
Header.
2. Upload your sticky logo image to the same folder where the main logo is stored.
3. The path of the main logo can be configured in Magento under System >
Configuration > Design > Header in the Logo Image Src field.
4. Name your sticky logo file the same as the file with the main logo, but add _sticky
suffix to the file name.
For example:
if your main logo file is my-logo.png, then your sticky logo file has to be named
like this: my-logo_sticky.png
5. Flush the cache.
Layout changes
•
Responsive layout breakpoints were slightly modified to match those in the
Bootstrap library. Bootstrap is used in many extensions so it's better to have similar
breakpoints in Ultimo theme.
'3XL'
'2XL'
'XL'
'L'
'M'
'S'
'XS'
'2XS'
'3XS'
•
=>
=>
=>
=>
=>
=>
=>
=>
=>
1920,
1680,
1440,
1200,
992,
768,
640,
480,
320,
There is more control over maximum page width under System > Configuration
> Theme Layout. There are more options in the Maximum Page Width field. For
7
example, you can set full-width pages globally for the entire website.
•
Predefined values in the Maximum Page Width field were changed a little bit
because of the changes in breakpoints, but you can also set any custom width.
To set custom width, in the Maximum Page Width select Custom width... from
the dropdown list. A new field Custom Maximum Page Width will appear below. In
that field, you can enter new page width in pixels (do not add "px" suffix).
Note:
the actual width of the content area is always a little bit smaller than the
selected breakpoint (maximum width). The actual width of the content area
also depends on the value of side padding which you can select individually
for each section of the page (e.g. under System > Configuration >
Theme Design > Main > Inner Container in the Side Padding field).
•
Because the responsive layout breakpoints were modified in this version, you may
want to set custom width to have exactly the same width of the content area as
you had in the previous version. But of course it's optional and you can as well use
the new width values.
Example:
if in previous version you set the Maximum Page Width to 1360 px, you need to do
the following to have exactly the same width of the content area in the current
version:
◦ select Custom width... in the Maximum Page Width field,
◦ and then enter 1300 in the Custom Maximum Page Width field.
Here is the list of modified breakpoints and corresponding values which you need to
set in the Custom Maximum Page Width field to have exactly the same width of the
content area as you had in the previous version:
◦ breakpoint: 1024 px → Custom Maximum Page Width: 960
◦ breakpoint: 1280 px → Custom Maximum Page Width: 1200
◦ breakpoint: 1360 px → Custom Maximum Page Width: 1300
8
1.4 Ultimo version 1.15.4
This is a compatibility update for Magento 1.9.2.2 and the patch bundle SUPEE-6788.
Magento 1.9.2.2 and patch SUPEE-6788 address several security issues, all details can
be found here:
•
http://magento.com/security/patches/supee-6788-technical-details
•
http://magento.com/security/patches/supee-6788
•
http://magento.stackexchange.com/a/87262/764
You can simply upgrade your installation to Magento 1.9.2.2 version which includes all the
latest security patches (SUPEE-5344, SUPEE-5994, SUPEE-6285, SUPEE-6482,
SUPEE-6788).
If Magento upgrade is not possible due to some reasons, you still can apply the patch via
FTP upload as shown in this article (useful if you have no SSH access):
https://magentary.com/kb/install-supee-6788-without-ssh/
Before applying patch SUPEE-6788, make sure to apply all previous patches.
White list of allowed blocks
Magento 1.9.2.2 introduces a white list of allowed block types. If a block was added to a
CMS page or to a static block through a CMS shortcode (for example: {{block
type="cms/block"}}), and the block is not on the white list, it will not be displayed on
frontend. In that case you will see a notice in your system log file under /var/log/,
similar to the following:
Notice: Undefined variable: block in D:/xampp/htdocs/_STAGE/m192200/app/code/core/Mage/Core/Model/Email/Template/Filter.php on line 187
Note:
log file will only be created if logging is enabled in your Magento. Logging
can be enabled under System > Configuration > Developer.
9
The white list of allowed blocks can be found under System > Permissions > Blocks
(only in Magento 1.9.2.2 and later).
The permission system normally only allows a reduced number of blocks:
core/template
catalog/product_new
If you are using Magento 1.9.2.2, Ultimo update 1.15.4 will add theme's blocks to the white
list:
cms/block
catalog/product_list
ultimo/product_list_featured
ultraslideshow/slideshow
brands/brands
ultramegamenu/navigation
If installation of the theme update goes correctly, you will see all the added blocks on the
white list. You will also find a log file Infortis_Ultimo.log under /var/log/ with a
confirmation: "Successfully added allowed blocks to Magento's white list".
If some of the blocks are already on the white list (e.g. if you manually added blocks to the
list), you can see a notice in the system log file similar to the following:
SQLSTATE[23000]: Integrity constraint violation: 1062 Duplicate entry 'cms/block' for key
'UNQ_PERMISSION_BLOCK_BLOCK_NAME', query was: INSERT INTO `permission_block` (`block_name`,
`is_allowed`) VALUES (?, ?)
1.5 Ultimo version 1.15.0
Below you can find the list of changes and improvements in this version.
10
Full width page
•
You can select 1 column, full width in the Layout field of the CMS page
configuration and the content of the page will be stretched to full width of the
browser viewport. See chapter 6.1.2.C Full width page in the user guide for more
details
•
Selected page sections can be stretched to full width (System > Configuration
> Theme Design).
Header
•
Mini Cart drop-down and Mini Compare drop-down can be displayed inside the
menu bar. Position of these blocks can be changed under System >
Configuration > Theme Settings > Header
•
You can change the height of the top header and height of the following blocks in
the primary header: Mini Cart drop-down, Mini Compare drop-down and Top Links.
These options can be found under System > Configuration > Theme Design.
Footer
You can add footer background image.
Changes in static blocks
Below you can see identifiers of the static blocks which are deprecated and will be
removed in next versions.
Instead of these static blocks you can now use containers which are much more flexible.
Containers give you ability to assign custom static blocks to selected areas of the page
(e.g. to the left sidebar), but additionally you can also choose the type of pages on which
your blocks will be displayed. See chapter 4.8.1 Add blocks to selected pages in the
user guide for more details.
The screenshot below presents positions of containers which are available on every page
of the store, including home page, product pages, category pages:
11
List and description of all containers can be found in chapter 6.2.1 Page in the user guide.
12
Deprecated static blocks:
The following static blocks will be removed in next versions. Instead of these predefined
static blocks you can now assign your custom static blocks to containers.
•
block_left_top – block at the top of the left sidebar.
•
block_left_bottom – block at the bottom of the left sidebar.
•
block_right_top – block at the top of the right sidebar.
•
block_right_bottom – block at the bottom of the right sidebar.
•
block_home_left1 – block at the top of the left sidebar on the home page.
•
block_home_left2 – the same as block above.
•
block_home_left3 – the same as block above.
•
block_home_right1 – block at the top of the right sidebar on the home page.
•
block_home_right2 – the same as block above.
•
block_home_right3 – the same as block above.
Removed static blocks:
The following static blocks were removed in this version. Instead of these predefined static
blocks you can now assign your custom static blocks to containers.
•
block_cms_page_top – block at the top of any CMS page.
•
block_category_above_collection – block above the products listing in the category
view.
•
block_opc_below_progress – block below the checkout progress block.
•
block_home_preface – block at the top of the home page, above sidebars and main
content area.
•
block_home_postscript – block at the bottom of the home page, below sidebars and
main content area.
13
1.6 Ultimo version 1.14.0
In this version we added more options for site header configuration. For example:
•
You can move elements such as search box or Mini Cart to the top of the header.
See chapter 7.1 Header in the user guide for more details.
•
Main menu items can be centered within the menu bar
•
Mini Cart and Mini Compare blocks are displayed in the sticky header
•
There are also new containers for custom blocks in the header. You can easily
assign any number of custom static blocks to each container:
See chapter 6.2.1 Header in the user guide for more details about new header containers.
1.7 Ultimo version 1.13.0
In this version we added new options for site header configuration. You have more control
over the width of header sections (left column, central column, right column). You can also
assign header elements (such as search box, logo, links) to selected sections.
14
All new options are described in the user guide, chapter 7.1 Header.
Important:
if you notice any problems after the upgrade, for example, some elements of
the header (such as search box) are not displayed as expected (or are not
displayed at all), please flush Magento cache and clear your web browser's
cache.
You may also need to go to System > Configuration > Theme Settings > Header
and manually assign the search box to proper section. After that, again flush Magento
cache in order to see changes on front-end.
1.8 Ultimo version 1.12.0
In this version we rebuilt and much improved the product page. There are also many other
improvements, especially in the layout of the category view.
Product page
There are many new options and the store admin has now much more control over many
different elements of the product page. For example:
15
•
position of tabs, related products and up-sell products
•
display: product reviews, product tabs, related products, up-sell products in the tabs
or outside the tabs
•
configuration of tabs/accordion
•
width of the product page sections
All new options are described with details in the user guide, chapter 7.5 Product Page.
There are also new containers for custom blocks on product page. You can easily assign
any number of custom static blocks to each container. See chapter 6.2.4 Product page for
more details. Details and example of assigning static blocks to containers can be also
found in chapter 4.8.1 Add blocks to selected pages.
Category view
•
Layered navigation is now displayed above the products in mobile view and the
filters are collapsed.
16
•
Sidebar blocks are collapsed in mobile view.
Collapsible blocks
•
Collapsible blocks are now opened/collapsed by clicking the title bar of the block.
Opener icons (small squares with [+] sign) were removed.
•
Don't use both classes collapsible and mobile-collapsible in one block.
•
The active class (if you want the block to be collapsed by default) has to be
added to the title bar, not to the main wrapper (like it was in previous versions).
Here is an example of the new structure:
My block title
Sample collapsible content
See more details in the user guide, chapter 6.5.2 Collapsible blocks.
Other changes
With 2 new parameters, you can now control order and sorting direction of products in the
Featured Products slider. For details, refer to chapter 6.1.4 Featured Products Slider in
the user guide.
1.9 Ultimo version 1.11.1
In this version we fixed some minor bugs (e.g. for Magento 1.9.1.0 bug with "Only X Left"
table on configurable product page). List of all changes can be found in Changelog.txt.
17
1.10 Ultimo version 1.11.0
Since this version Ultimo is compatible with Magento 1.9.1.0. If you are using older version
of Magento, you can ignore this update.
1.11 Ultimo version 1.10.4
In this version we improved rich snippets on product page. You can choose (in System >
Configuration > Theme Settings > Rich Snippets) if rich snippets will use product
prices including or excluding tax. We also added support for bundle products and different
price types: price range, "As low as", fixed price. All these price types are now included in
rich snippets.
Important:
this file (which was added in version 1.10.2) needs to be removed from your
Magento:
/app/design/frontend/ultimo/default/template/catalog/pro
duct/price.phtml
Otherwise rich snippets will not work correctly.
jQuery will be upgraded in next major update of Ultimo. If you would like to upgrade it now,
please follow the instructions in the previous chapter: 1.13 Ultimo version 1.10.2.
1.12 Ultimo version 1.10.3
In this version we added a workaround for the bug in Safari on iPads and iPhones with
iOS8 (description of the bug: https://bugs.webkit.org/show_bug.cgi?id=137032). Because
of this bug, the product grid in the category view is sometimes displayed incorrectly in
Safari – each row (except the last row) should have the same number of products, but
sometimes products drop to another row. The workaround for this bug is to replace CSS
pseudo-class :nth-child with :nth-of-type in CSS styles of the product grid.
After you install the new version, re-save theme settings (clicking Save Config button) in
System > Configuration > Ultimo > Theme Layout, and then flush the cache.
If you're using Magento Compilation mode, you will also need to re-compile.
18
1.13 Ultimo version 1.10.2
In version 1.10.2 we added support for rich snippets (the few lines of text that appear
under every search result in Google search). Several template files had to be slightly
modified.
Breadcrumbs
There were also some minor changes in CSS of the breadcrumbs (to prepare that block
for rich snippets). So if you will notice (after upgrade) that the breadcrumbs on your site
have double arrows, it means that the CSS of the breadcrumbs was not upgraded
properly. What can cause this:
1. Not all new CSS files were uploaded or old files were not overwritten:
◦ /skin/frontend/ultimo/default/css/override-theme.css
◦ /skin/frontend/ultimo/default/css/styles.css
2. Or you have some custom CSS styles (e.g. inside custom.css) which overrides
the new CSS of the breadcrumbs.
Upgrade of jQuery in next version
We also want to announce that in next release of Ultimo we will upgrade jQuery library to
version 1.11.1.
It was already tested and works correctly with Ultimo, but we just want to give more time to
users which have third-party extensions installed in their Magento – many extensions still
relies on older versions of jQuery so to avoid problems with compatibility we want to ask
you to check and test your extension with newer jQuery before the next release of Ultimo.
In case some extensions are not compatible with new jQuery, you will be able to leave the
current version of jQuery in Ultimo, it will still work without problems.
If you would like to upgrade it (or just test it) now, here's the location of jQuery in Ultimo:
js/infortis/jquery/jquery-1.7.2.min.js
To upgrade jQuery:
•
remove that file
19
•
then download new version from http://code.jquery.com/jquery1.11.1.min.js
•
upload it to the folder js/infortis/jquery/
•
remove the existing file jquery-1.7.2.min.js
•
and finally rename uploaded file jquery-1.11.1.min.js to jquery1.7.2.min.js
Thanks to renaming the file, you will not need to make any additional changes in Magento
layout XML files which load the jQuery to the frontend.
1.14 Ultimo version 1.10.0
In version 1.10.0 there are improvements of the page header displayed on mobile devices
with narrow screens. We also added font icons and made some changes in CSS of
different elements to make them work correctly with new icons. All the details about new
features and available options can be found in the user guide.
Header
Mobile header
If mobile header is enabled, the standard header is transformed into a mobile-friendly
header on small mobile devices (if browser viewport is narrower than 770 pixels). Thanks
to that the header takes less space than in previous versions and the layout is cleaner.
New option can be found in System > Configuration > Theme Settings > Header.
If mobile header is enabled, option System > Configuration > Menu > Main Menu
Mode has to be set to Drop-down/Mobile or Mobile.
Sticky menu
If sticky menu is enabled, the main menu does not disappear when the user scrolls down
the page. This option can be found in System > Configuration > Theme Settings >
Header.
20
Font icons
Old icons were replaced with much better and more powerful font icons. Font icons give
you more control over the visual appearance of the icons. Now changing color or size of
the icon is as easy as adding CSS class or applying inline styles.
You will need to rebuild the markup of your icons to make them look correctly and work
correctly with all the new options. Below you can find some examples of the old markup
and the changes that have to be made.
Note:
all the details about the new markup can be found in the user guide.
"Image sprite" icons
Many new icons were added in this version, old icons created with image sprites were
replaced with font icons. Full list of available icons can be found in the user guide. Replace
old classes with new classes in your icon containers to display new font icons correctly.
Just like in the example below:
Old:
New:
There are also many new options to control the look of the icons (e.g. size, color,
background color, position etc.). For example, to increase the letter icon from the
previous example, all you need to do is to add a class to the icon element, for example
ic-lg, ic-2x, ic-3x etc.
No need to edit image files anymore to increase the size or change the color of the icon.
All can be done with predefined classes or with simple CSS.
21
Social icons
To add icons of social networking services you need to use exactly the same markup as
for other font icons.
Old:
New:
Icons with custom images
Old:
 New:
New:
 If you have used class large to increase the size of the icon, this class has been changed
too. Now there are more classes to control the size - refer to the user guide for more
details, chapter 6.5.3.B Icons with background color (iconbox). Here's an example:
Old:
If you have used class large to increase the size of the icon, this class has been changed
too. Now there are more classes to control the size - refer to the user guide for more
details, chapter 6.5.3.B Icons with background color (iconbox). Here's an example:
Old:
 New:
22
New:
22
 Text with icon
A block of text (paragraphs, links, headings etc.) with additional icon.
Here's an example with custom images as icons:
Old:
New:
Note that in the main container of the block, class large was replaced with class
indent-size-l. And in the icon, class large was replaced with class ib-size-l.
Here's an example with predefined icons:
Old:
New:
23
Note that if the div with class feature doesn't have class indent, you will need to add
class left to the icon in order to place the icon along the left side of its container.
Characters as icon
Letters, numbers and characters as icons.
Old:
2
New:
2
1.15 Ultimo versions 1.9.0 - 1.9.4
In version 1.9.x there are many improvements and changes in the main menu. The most
important changes are described below. All the details about new features and available
options can be found in the user guide.
Make a backup of category blocks before upgrade
Important:
before you upgrade Ultimo to version 1.9.0 (or to later version), you need to
24
make a copy of the custom content of all the category blocks in your
categories.
You can copy it to a simple text file. It will be needed to recreate your drop-down boxes
in the new version of the menu. Go to Catalog > Category Management, select a
category, open the Menu tab and make a copy of the content which you have in these
fields:
Block Right, Block Top and Block Bottom:
To avoid issues with menu upgrade
To avoid issues with the upgrade of the menu module, strictly follow all the instructions
provided in chapter 2. Upgrade procedure. Especially remember to do the following:
•
Before you upload theme files, make sure your store is disabled: put Magento in the
maintenance mode.
25
•
Files can sometimes get broken if you sent loose files (without zipping) via FTP. So
it is highly recommended to upload zipped files: extract the Theme.zip archive
directly on your server. This will eliminate potential issues with missing/broken files.
•
You can see all sorts of errors if Magento doesn't have access to all uploaded files
(e.g. because of incorrect file permissions on your server). You need to set correct
file permissions for all the theme files (the same as for other Magento files).
Permissions may differ depending on server. In case of any doubts, please contact
your hosting provider. Refer to this article for more details:
http://www.magentocommerce.com/wiki/1__installation_and_configuration/magento_filesystem_permissions
•
Files inside this directory are crucial to make a correct upgrade of the menu
module:
app/code/local/Infortis/UltraMegamenu/data/ultramegamenu_setup/
They have to be accessible for Magento during the upgrade process.
•
Reindex Magento and flush the cache after upgrade.
Menu re-configuration
Set drop-down type
In this version, options “Enable Classic Style” and “Enable Wide Style” were removed.
Now the style (type) of the drop-down box can be selected individually for each category.
After upgrading, you will notice that all the drop-downs were reset to “classic” type, and
they look like on this screenshot:
You will need to re-configure your menu to set the same look as you had in previous
version. To do this, go to Catalog > Category Management, select a category, open the
Menu tab and in the Submenu Type field select the type of the drop-down:
•
If in the previous version you have used “Wide style”,
select Mega drop-down
26
•
If in the previous version you have used “Classic style”,
select Classic drop-down (or leave it empty because the classic type is the
default type)
You need to do this for each top-level category which has a drop-down box (meaning: for
each top-level category which has any active subcategories).
Important:
after making these changes you may need to reindex Magento and flush the
cache.
Restore content of your category blocks
In the same Menu tab, you can restore the content of your category blocks. If you made a
copy of the category blocks before the upgrade, you can now insert it back to the category
blocks of the new menu.
You will notice that there is an additional block named Left Block. Content inserted into
that block will be displayed at the left side of the subcategories in the mega drop-down
box.
27
Drop-down box configuration
Here's a short summary of new options related to drop-down boxes:
•
Drop-down style
Options "Enable Classic Style" and "Enable Wide Style" were removed. Now the
style (type) of the drop-down can be selected individually for each category.
•
Multiple styles in one menu
Additionally, all of the drop-down types can be mixed together. For example, a
simple classic drop-down can be nested inside a mega drop-down.
•
Multilevel menus
Multilevel menus are fully supported, categories inside a drop-down box can have
their own subcategories which will also be displayed in drop-down boxes.
•
Drop-down width
Width of the drop-down box can be changed individually for each category.
•
Custom blocks in the mobile menu
Category blocks with custom content can be now displayed also in the mobile
version of the menu.
Custom drop-down boxes and custom links in the menu
In the new version you can easily add multiple custom drop-down boxes to the menu. For
more details refer to the user guide, chapter 13.4 Custom drop-down boxes in the
menu.
There's also a new better method to add custom links to the menu. For more details refer
to the user guide, chapter 13.3 Custom links in the menu.
Old method for custom links in the menu
If you're using static block block_nav_links to display custom links in the menu, the
content of that block needs to be slightly modified – a new class was added to the
Text with icon
A block of text (paragraphs, links, headings etc.) with additional icon.
Here's an example with custom images as icons:
Old:
New:
Note that in the main container of the block, class large was replaced with class
indent-size-l. And in the icon, class large was replaced with class ib-size-l.
Here's an example with predefined icons:
Old:
New:
23
Note that if the div with class feature doesn't have class indent, you will need to add
class left to the icon in order to place the icon along the left side of its container.
Characters as icon
Letters, numbers and characters as icons.
Old:
2
New:
2
1.15 Ultimo versions 1.9.0 - 1.9.4
In version 1.9.x there are many improvements and changes in the main menu. The most
important changes are described below. All the details about new features and available
options can be found in the user guide.
Make a backup of category blocks before upgrade
Important:
before you upgrade Ultimo to version 1.9.0 (or to later version), you need to
24
make a copy of the custom content of all the category blocks in your
categories.
You can copy it to a simple text file. It will be needed to recreate your drop-down boxes
in the new version of the menu. Go to Catalog > Category Management, select a
category, open the Menu tab and make a copy of the content which you have in these
fields:
Block Right, Block Top and Block Bottom:
To avoid issues with menu upgrade
To avoid issues with the upgrade of the menu module, strictly follow all the instructions
provided in chapter 2. Upgrade procedure. Especially remember to do the following:
•
Before you upload theme files, make sure your store is disabled: put Magento in the
maintenance mode.
25
•
Files can sometimes get broken if you sent loose files (without zipping) via FTP. So
it is highly recommended to upload zipped files: extract the Theme.zip archive
directly on your server. This will eliminate potential issues with missing/broken files.
•
You can see all sorts of errors if Magento doesn't have access to all uploaded files
(e.g. because of incorrect file permissions on your server). You need to set correct
file permissions for all the theme files (the same as for other Magento files).
Permissions may differ depending on server. In case of any doubts, please contact
your hosting provider. Refer to this article for more details:
http://www.magentocommerce.com/wiki/1__installation_and_configuration/magento_filesystem_permissions
•
Files inside this directory are crucial to make a correct upgrade of the menu
module:
app/code/local/Infortis/UltraMegamenu/data/ultramegamenu_setup/
They have to be accessible for Magento during the upgrade process.
•
Reindex Magento and flush the cache after upgrade.
Menu re-configuration
Set drop-down type
In this version, options “Enable Classic Style” and “Enable Wide Style” were removed.
Now the style (type) of the drop-down box can be selected individually for each category.
After upgrading, you will notice that all the drop-downs were reset to “classic” type, and
they look like on this screenshot:
You will need to re-configure your menu to set the same look as you had in previous
version. To do this, go to Catalog > Category Management, select a category, open the
Menu tab and in the Submenu Type field select the type of the drop-down:
•
If in the previous version you have used “Wide style”,
select Mega drop-down
26
•
If in the previous version you have used “Classic style”,
select Classic drop-down (or leave it empty because the classic type is the
default type)
You need to do this for each top-level category which has a drop-down box (meaning: for
each top-level category which has any active subcategories).
Important:
after making these changes you may need to reindex Magento and flush the
cache.
Restore content of your category blocks
In the same Menu tab, you can restore the content of your category blocks. If you made a
copy of the category blocks before the upgrade, you can now insert it back to the category
blocks of the new menu.
You will notice that there is an additional block named Left Block. Content inserted into
that block will be displayed at the left side of the subcategories in the mega drop-down
box.
27
Drop-down box configuration
Here's a short summary of new options related to drop-down boxes:
•
Drop-down style
Options "Enable Classic Style" and "Enable Wide Style" were removed. Now the
style (type) of the drop-down can be selected individually for each category.
•
Multiple styles in one menu
Additionally, all of the drop-down types can be mixed together. For example, a
simple classic drop-down can be nested inside a mega drop-down.
•
Multilevel menus
Multilevel menus are fully supported, categories inside a drop-down box can have
their own subcategories which will also be displayed in drop-down boxes.
•
Drop-down width
Width of the drop-down box can be changed individually for each category.
•
Custom blocks in the mobile menu
Category blocks with custom content can be now displayed also in the mobile
version of the menu.
Custom drop-down boxes and custom links in the menu
In the new version you can easily add multiple custom drop-down boxes to the menu. For
more details refer to the user guide, chapter 13.4 Custom drop-down boxes in the
menu.
There's also a new better method to add custom links to the menu. For more details refer
to the user guide, chapter 13.3 Custom links in the menu.
Old method for custom links in the menu
If you're using static block block_nav_links to display custom links in the menu, the
content of that block needs to be slightly modified – a new class was added to the Source Exif Data:
File Type : PDF File Type Extension : pdf MIME Type : application/pdf PDF Version : 1.4 Linearized : No Page Count : 47 Language : pl-PL Creator : Writer Producer : OpenOffice.org 3.4.1 Create Date : 2016:11:30 21:35:12+01:00EXIF Metadata provided by EXIF.tools