Skip to content

Commit 2a8705d

Browse files
scottcwilsonscottcwilson
committed
v 2.1.0 changes
1 parent d95b7a0 commit 2a8705d

6 files changed

Lines changed: 39 additions & 27 deletions

File tree

‎content/release/whatsnext.md‎

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -19,13 +19,17 @@ The improvements targeted for v2.2.0 include:
1919
The improvements targeted for v2.1.0 include:
2020
- New Feature: <a href="https://github.com/zencart/zencart/discussions/6428">Child Templates</a> will be supported, so that storeowners can more easily determine what has been changed from the base release of a template.
2121
- New Feature: The Zen Cart admin will be secured with <a href="https://github.com/zencart/zencart/pull/6350">Multi Factor Authentication</a>.
22-
- Admin: The <a href="/dev/code/template_settings/">template settings file</a> may now be viewed from your admin page.
22+
- Admin: FIXED - Searching for customers from the orders page would occasionally lead to a blank right hand infoBox.
23+
- Admin: FIXED - Selecting coupons on pages other than the first page would occasionally fail.
24+
- Admin: The <a href="/dev/code/template_settings/">template settings file</a> may now be viewed from your admin page.
2325
- Admin: The date of last password change is now shown on the Users page in admin.
2426
- Admin: Product Price fields "Gross" and "Net" have been renamed to "Tax Included" and "Tax Excluded."
2527
- Core: Retired Notifiers and Observers can be set to generate deprecated logs automatically.
26-
- Core: The introduction of the `Product` class continues the modernization of Zen Cart.
28+
- Core: The introduction of the `Product` class continues the modernization of Zen Cart.
2729
- Core: Shipping modules now inherit from ZenShipping base class to reduce code duplication and ensure consistency.
2830
- Core: Zones module now has exception rules notifier. See <a href="/user/shipping/exceptions/">this page</a> for details on usage.</li>
31+
- Storefront: Additional image matching rules now are enforced more strictly; see [this page](/user/images/additional_images/#additional-images-filename-matching-rules). This behavior can be disabled in the [site specific overrides file](/user/customizing/site_specific_overrides/).
32+
- Extras: Improved the modernized utilities in the `/extras` folder.
2933

3034
## 2.0.1
3135
Release 2.0.1 has been delivered; changes are now listed in [What's New in 2.0.x](/release/whatsnew_2.0.0.html).

‎content/user/_index.md‎

Lines changed: 3 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -8,14 +8,8 @@ menu:
88
layout: docs
99
---
1010

11-
Quick Links: &nbsp;
12-
&nbsp; [All FAQs](/user/_allpages/) &nbsp; |
13-
&nbsp; [Top FAQs](/user/all_time_favorites/) &nbsp; |
14-
&nbsp; [All Admin Menus](/user/admin_pages/menu_sections/) &nbsp; |
15-
&nbsp; [All Configs](/user/admin_pages/configuration/all/) &nbsp; |
16-
&nbsp; [Glossary](/user/first_steps/glossary/) &nbsp; |
17-
&nbsp; [Release Docs](/release/)
11+
### :rocket: &nbsp; [All FAQs](/user/_allpages/) &nbsp; | &nbsp; [Top FAQs](/user/all_time_favorites/) &nbsp; | &nbsp; [All Admin Menus](/user/admin_pages/menu_sections/) &nbsp; | &nbsp; [All Configs](/user/admin_pages/configuration/all/) &nbsp; | &nbsp; [Glossary](/user/first_steps/glossary/) &nbsp; | &nbsp; [Release Docs](/release/)
1812

19-
What's New with Zen Cart? [Click here to find out](/user/about_us/whats_new/).
13+
### [:new: What's New with Zen Cart?](/user/about_us/whats_new/)
2014

21-
What's Next for Zen Cart? [Click here to find out](/release/whatsnext/).
15+
### [:fast_forward: What's Next for Zen Cart?](/release/whatsnext/)

‎content/user/customizing/site_specific_overrides.md‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -29,6 +29,7 @@ Many behaviors can be enabled or disabled by this file, such as:
2929
- set category counts to count only distinct products: if a product is in two different sub categories of a parent category it will only be counted once (```'COUNT_DISTINCT_PRODUCTS'```).
3030
- for Checkout Shipping, when no shipping method is available, substitute the Continue button with a Contact Us button (```$show_contact_us_instead_of_continue```).
3131
- for Product Listing: enable the legacy sorting by column heading (```$show_table_header_row```).
32+
- Enable legacy additional filename matching logic (```$use_legacy_additional_image_matching```). See [this page](/user/images/additional_images/#additional-images-filename-matching-rules) for details.
3233

3334
See the file itself for further details.
3435

‎content/user/images/additional_images.md‎

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -13,6 +13,15 @@ then clicking *Layout Settings*, and setting `Show Product Additional Images` to
1313
Then add additional images for your products, following the naming
1414
conventions set out in [Image Filename conventions](/user/images/image_filename_conventions/).
1515

16+
### Additional images filename matching rules
17+
18+
Using an underscore and more characters after the base filename is the best practice for ensuring your additional images work as expected. See [Image Filename Conventions](/user/images/image_filename_conventions/) for details.
19+
20+
Prior to Zen Cart 2.1.0, image matching did not enforce the check of a `_` suffix when looking for additional product images in the "images/" directory (but it DID require the `_` in any "images/whatever/" subdirectories). Since v2.1.0 the `_` is required in both locations.
21+
22+
Stores that are upgrading and wish to retain the old functionality can enable the legacy mode via the [site specific overrides file](/user/customizing/site_specific_overrides/) by setting $use_legacy_additional_image_matching to true.
23+
24+
1625

1726
### How do I disable the additional images feature?
1827

‎content/user/images/image_filename_conventions.md‎

Lines changed: 19 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -19,33 +19,37 @@ directory via the drop down.
1919

2020
Now you use your [FTP tool](/user/first_steps/useful_tools/#ftp-tools) to upload additional images to `/images/dvd`.
2121

22-
* a_bugs_life_01.gif
23-
* a_bugs_life_02.gif
24-
* a_bugs_life_03.gif
25-
* a_bugs_life_04.gif
22+
Name them with the original filename and a suffix starting with `_`.
2623

27-
I used the numbers so these would load in order, as the additional images are loaded alpha/numeric.
24+
For example, since the original filename was `a_bugs_life.gif` we willl name our additional images as follows:
2825

29-
For the large image (used in popups) I use FTP and upload:
26+
* `a_bugs_life_01.gif`
27+
* `a_bugs_life_02.gif`
28+
* `a_bugs_life_03.gif`
29+
* `a_bugs_life_04.gif`
3030

31-
* /images/large/dvd/a_bugs_life_01_LRG.gif
32-
* /images/large/dvd/a_bugs_life_02_LRG.gif
33-
* /images/large/dvd/a_bugs_life_03_LRG.gif
34-
* /images/large/dvd/a_bugs_life_04_LRG.gif
31+
Using numbers means these would load in order, as the additional images are loaded by alphanumeric sort.
32+
33+
For the large image (used in popups) use FTP and upload:
34+
35+
* `/images/large/dvd/a_bugs_life_01_LRG.gif`
36+
* `/images/large/dvd/a_bugs_life_02_LRG.gif`
37+
* `/images/large/dvd/a_bugs_life_03_LRG.gif`
38+
* `/images/large/dvd/a_bugs_life_04_LRG.gif`
3539

3640
For the medium image (used as the main image on the product_info page) I upload via FTP:
3741

38-
* /images/medium/dvd/a_bugs_life_MED.gif
42+
* `/images/medium/dvd/a_bugs_life_MED.gif`
3943

4044
**NOTE:** There is <font color="#ff0000">ONLY ONE Medium Image</font> used per Product on the Product Info page: (pages named product_info, product_music_info etc.) The naming is related directly to the original image.
4145

4246
Now you do not need to use subdirectories for loading your images.
4347

4448
All images can be loaded to:
4549

46-
* /images
47-
* /images/large
48-
* /images/medium
50+
* `/images`
51+
* `/images/large`
52+
* `/images/medium`
4953

5054
## Suffixes
5155

@@ -156,7 +160,7 @@ b. You can edit the `_MED` and `_LRG` defined suffixes in [Admin > Configuration
156160
# TIPS
157161

158162
**NOTE:** Do no use the following symbols in your image filenames:
159-
<font color="#ff0000">**+ [ ] $ ' " \ / () **</font>
163+
```+ [ ] $ ' " \ / ( )```
160164

161165
Also, in case it's not self-evident, the files have to actually exist on your server. So, if you're selecting the "Use an image on the server" instead of uploading a file directly, and things aren't showing up, then that probably means the image file you specified doesn't actually exist on the server.
162166

‎content/user/upgrading/release_specific_upgrade_considerations.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -26,7 +26,7 @@ This document lists things you may wish to take into account as you upgrade. Th
2626

2727
### Zen Cart 2.1.0 :stop_sign: <font color="red">NOT RELEASED YET</font> :stop_sign:
2828

29-
- This release introduces a `Product` class to consolidate product-related operations and queries.
29+
- Storefront: Additional image matching rules now are enforced more strictly; see [this page](/user/images/additional_images/#additional-images-filename-matching-rules). This behavior can be disabled in the [site specific overrides file](/user/customizing/site_specific_overrides/).
3030
- The `NOTIFY_GET_PRODUCT_DETAILS` notifier has been deprecated in favor of `NOTIFY_GET_PRODUCT_OBJECT_DETAILS`, which uses different arguments. Any use of the former will product a deprecation debug log.
3131

3232
### Zen Cart 2.0.x

0 commit comments

Comments
 (0)