You do not need to uninstall the module before updating it. In fact, uninstalling the modules will remove all created instances.

Before updating, make sure you read the change logs and are aware of potential backward compatibility issues.

Cached scripts and styles are removed on update. Updates fix issues, add features and/or improve performance and these wouldn't be reflected unless all cached files are re-generated.

Migrating to v4.7.x from v4.6.x

Redundant code has been removed from the extension and to take advantage of the new functionality (such as Bootstrap compatibility), you need to update your template overrides of the module, the views and the layouts (content and pagination only). Note that your overrides should not 'break' until you update them. As usual, using a test site to check this new update is highly recommended.

Pro A Joomla 3.8+ version is now available with features and code updates that are not compatible with prior versions of Joomla. Depending on the Joomla version you are using, the proper version will be automatically installed (if you are using your download id). If you update manually, please make sure you download the right version!

Pro

Migrating to v4.6.x from v4.5.x

Layouts are now placed in sub-folders to become visible and easily accessible in your template's overrides tab. You will need to move your overrides into identically named folders (your overrides won't be visible until you move them). For more information, check the layouts section in this documentation.

Warning You will get a warning in place of your module instance in case it is mis-configured (when using animations) and you set Show Errors to Yes.

Pro

Migrating to v4.5.x from v4.4.x

If you want to take advantage of the new features for the blog views, make sure you update the blog view overrides, if you have any.

CSS overrides of blog views The items' markup has been modified to allow headings. Items are now enclosed in a <div>, were previously they were enclosed in a <li>. You will need to modify any CSS override from ul.latestnews-items to .latestnews-items and li.latestnews-item to .latestnews-item.

To adjust space between items, you can now use the parameter Space between from the Layout tab.

Behavior modification When 2 or more categories are selected, the option per category of the selection tab will show the total max of articles for those categories ONLY (the sub-category items are considered part of the top most parent category).

For instance, when showing 2 items max per category and selecting 3 categories, the max number of items that will show will be 2*3 = 6.

Starting with this version, you can now use the new download id that is associated with the extension. This will allow you to make one-click updates through the Joomla installer, without the need to download the updates manually.

Go to Extensions -> Plugins and select the Installer type.
Enter the download id (found on the site under 'My purchased licenses' once you are logged in) in the enabled Latest News Enhanced Pro installer plugin.

Pro

Migrating to v4.4.x from v4.3.x

If you want to take advantage of the new features for the category index selection box, make sure you update the category index layout override, if you have any.

Migrating to v4.3.x from v4.2.x

Mobile device detection has been improved and the module's mobile options are more accurate as a result.

Migrating to v4.2.x from v4.0.x or v4.1.x

Read more link default label behavior has been simplified and is more logical.
Historically, the old behavior used to make sense when the option to show the read more link was bound to what value was set in the read more label. In newest versions, you need to specifically select read more to show the link or not, no matter the value for the read more label.

Old behavior

title shows title does not show
Read more label is set read more label read more label
Read more label is missing X X

New behavior

title shows title does not show
Read more label is set read more label read more label
Read more label is missing full title full title

Example when the link is the url A and the url A value is set

Old behavior

url A label is set url A label is missing
Read more label is set url A label read more label
Read more label is missing url A label X

New behavior

url A label is set url A label is missing
Read more label is set read more label read more label
Read more label is missing url A label full title

Migrating to v4.0.x from v3.1.x

This version, besides adding view capabilities, 'cleans up' a few areas of the module, introducing a few backward incompatibilities. Therefore you will need to proceed with caution and read the following recommendations BEFORE migrating for a smooth transition:

Before updating to v4.0.x

1 Pro Major Removed deprecated option for share icons

To avoid any issues, save your old module instances with use deprecated set to no for share icons and set the include values as desired (to replace the old way share icons were selected).

2 For each module instance, take notes of:

  • Pro K2 is it using the K2 avatar as author?
  • Pro is it using a calendar background image? If so, where is it located?
  • is it showing a specific date format (Days Ago/Yesterday/Today, ...)? If so, which one?
  • are the items linked? If so, on the title, as an appended link or as a read more link?
  • are the item categories showing? If so, where (first, over the picture, before the title or last)? Are the categories linked?
  • Pro are all individual items identical in structure (no leading items used) ?

After updating to v4.0.x

1 Pro Minor Calendar images are now found under images/calendars rather than images/lnee/calendars

When using a calendar background image located in the old directory, re-select it from the new one.
Once your configuration is ready, you can safely remove the old images/lnee/calendars directory.

2 Minor Thumbnail images are found under images/thumbnails/lnep for the views (Pro) and under images/thumbnails/lne for the module (rather than images/thumbnails/lnee)

You can safely remove the old images/thumbnails/lnee directory.

3 Pro Minor K2 Removed author selection

When selecting Author as additional head element, all available author types are now selectable directly from the list of head elements. If the author was the K2 avatar in your previous configuration, you need to select it from the list of head elements prior to saving the module instance to avoid loosing your previous configuration.

4 Major Removed date selection (Days Ago/Yesterday/Today, ...)

When selecting Date as information detail, all available date types are now selectable directly from that list of information details.

There won't be any backward compatibility issue until the module instance has been saved. If you save the module instance without re-selecting the values, the date that was formatted as (Days Ago/Yesterday/Today, ...) will revert to the date itself.

5 Major Linking additions and changes

Your configuration remains un-touched until the module instance is saved again, in which case you will have to have done the proper re-selections.

Do not forget to select Appended link if you had the link appended to the text in the previous configuration.

6 Major Category changes

Category selection remains the same but is more intuitive and allows for more configuration options. Your configuration remains un-touched until the module instance is saved again, in which case you will have to have re-selected the right options to get your previous configuration back.

Note If you did not show categories in the previous versions, the position will most likely default to last. Unset the value in order to keep categories hidden. You will also have to re-link the category if needed (link to).

7 Pro Major Leading items changes

There is an additional parameter that enables the leading items configuration. If you previously had leading items with full configuration and degraded (remaining) items without head, text and/or details, you need to set Use leading items to Yes. This has been done this way to reduce the confusion this feature generates.

8 Major Module templates have changed

Template overrides of the module should not break with the update but will not take advantage of the new feature set and improvements. Therefore, update your template overrides!

9 Pro Major Download and re-install styles (Boxed, Original Image) and data sources (Newsfeeds), compatible with v4.

Migrating to v3.1.x from v2.5.x

No backward compatibility issue except for the author field, which has been removed and replaced with a more advanced one. The new field defaults to 'all authors', therefore if you used the 'by me' or 'not by me' previous options, you will need to reset them.

Migrating to v2.5.x from v2.4.x

There are a few major differences in the modules (free and pro) since v2.4:

1 The first major change is the way information details classes are labelled. If you rely heavily on CSS to make changes to the standard output, you may need to make some modifications.

For instance:

<p class="details">
  <span class="detail detail_tags">
    <i class="SYWicon-tags"></i>
    <span class="news_tags">Tags : tag 1, tag 2, tag 3</span>
  </span>
</p>

is now:

<p class="details">
  <span class="detail detail_tags">
    <i class="SYWicon-tags"></i>
    <span class="detail_label">Tags : </span>
    <span class="detail_data">tag 1, tag 2, tag 3</span>
  </span>
</p>

There are a lot more options now to 'skin' the output and some of your CSS overrides may not be necessary anymore.

Pro You will loose icons between tags and between links a, b and c. They need to be re-set in the information tab.

2 The templates have been modified. Therefore, if you have module overrides, you will need to incorporate the updated code into your overrides. Modifications are mostly targeting the calendars' output.

3 Pro In order to get the latest changes to the additional Original image style, you will need to download and install it again.

4 Pro You need to re-select the share icons previously selected. The module is backward compatible with old values but that compatibility will be removed in the next major update.

5 The caching of stylesheets and scripts has gone through a total rewrite. It is no longer necessary to change file permission access on websites that have very tight security rules. If you have setup file permission access for the files of this module, you can now safely remove them from your server configuration.

You may still, however, run into access permissions under the new caching system. In that case, it is just a matter of granting access to (or white-list) the /cache folder created for the extension.

Free

Migrating to v2.x from v1.3.x

The new version is a complete rewrite, therefore, by updating to this version, you will loose some configuration settings.

Will be reset:

  • ordering,
  • show featured,
  • post date,
  • items width,
  • link to article,
  • head alignment (now body alignment),
  • default picture (now separate image and calendar background),
  • crop picture,
  • calendar settings (all but time formatting),
  • font reference,
  • title html tag,
  • letter count,
  • information detail selection,
  • date output,
  • information detail placement,
  • pagination (all but labels),
  • ALL additional CSS styles
    (among other changes, .latestnewsenhanced_23 becomes #lnee_23)

Will be removed:

  • first/last pagination,
  • simple styling.

DO NOT UPDATE ON A PRODUCTION SITE. Test the migration first.

Follow these steps when updating:

  1. [optional] Update the external library to the latest version if this has not been done previously,
  2. Install Latest News Enhanced v2.x,
  3. Open each module instance, check the parameters (reset the old ones and set the new ones) and SAVE,
  4. [optional] Check additional CSS styling, most class names are different.
Pro

Migrating to v2.x from v1.5.x

Although the update is pretty straight forward, DO NOT UPDATE ON A PRODUCTION SITE. Test the migration first.

It takes a few steps to make sure the update goes smoothly.
Those steps need to be done in the following order:

  1. [optional] Update the external library to the latest version if this has not been done previously,
  2. Install Latest News Enhanced Pro v2.x,
  3. [optional] Download and install the 'original image' style (if used originally - it is now offered as a separate download),
  4. Open each module instance, check the parameters and SAVE (it is important to save each instance in order to get all the new parameter changes recorded).

Notes:

Checking the parameters is important in the previous steps.
For instance, ‘Original’ and ‘Bleed’ styles have been merged into one. The ‘Wrap’ option will need to be used in order to have the same effect as previously. The ‘Bleed’ option been removed, you will need to check the styles option and make sure the ‘Original’ option is setup instead.

The same goes for the calendars: the calendar styles ‘Original’ and ‘Original CSS3’ have been merged into one. Therefore, if your previous module instance used ‘Original CSS3’, you will need to revert it to ‘Original’. Outdated styles may also be missing. Calendar background images are now selectable from the ‘/images’ folder. You may have lost your previous background image.

The same goes for animations. If you used the outdated animations ‘simple slide’, ‘simple fade’ or any ‘slide’ configuration, you will need to select one of the new animations.

The ‘justpagination’ animation has been removed. To get the same results, set animations to ‘no’ and pagination to ‘yes’.

The CSS overrides need to be checked out as stylesheets prefixes .latestnewsenhancedextended_[module id] have been changed to #lnee_[module id]. To change styles for all instances on the same page, use ‘.lnee’.

Finally, check the temporary folder global settings of your Joomla configuration. If set improperly, the images won’t show. You may need to change the module’s advanced option setting ‘thumbnail cache path’ to ‘/images’.

The page loading may be slow at first. Once the configuration of each module has been finalized, cache the stylesheets and images from the module’s advanced options.