Known bugs (and fixes) for v1.5.8 series

Confirmed bug reports and fixes for v1.5.8 will be posted here by the project maintainers.

As we find issues, we will fix them in Github for delivery in the next update to 1.5.8.

https://github.com/zencart/zencart

You can follow more 1.5.8 goings on in the discussion thread:

https://github.com/zencart/zencart/discussions/5320

There was a bug in the initial release relating to database version. Thanks to @mc12345678 for reporting this so quickly.

The issue has been fixed and these notes are only required for people who downloaded the build within the first 24 hours of availability (prior to 2022-10-17 at 05:05 AM EST.)

To fix the bug:

• In phpMyAdmin, update your project_version table. The most recent entries should refer to minor version 5.8 (not 5.8-dev).

Long time users who have had the product since before Zen Cart 1.5.6 may see an issue when going to Tools > EZ Pages. If you get a white screen, here is the fix: go to Admin > Tools > Install SQL Patches and run

ALTER TABLE customers_basket DROP COLUMN final_price;
ALTER TABLE ezpages DROP COLUMN languages_id;
ALTER TABLE ezpages DROP COLUMN pages_title;
ALTER TABLE ezpages DROP COLUMN pages_html_text;

NOTE: This should only affect users using a database prefix (e.g. "zen_" or "zc_") in their configure.php files.

If you don't yet have a configure.php file or a database, you must explicitly go to YOURSITE.com/zc_install if you are running PHP8+.

If you go to YOURSITE.com, PHP7 will show the Welcome to Zen Cart page, but PHP 8+ will show a blank page. Fixed in PR #5332

https://github.com/zencart/zencart/pull/5332/files

zen_get_products_manufacturers_image fails to work with newer MySQL implementations.

Update required to includes/functions/functions_products.php for 1.5.8.
Fix here:

https://github.com/zencart/zencart/pull/5360/files

CEON URI Mapping users who are not able to view EZ Pages will need this patch:
https://github.com/zencart/zencart/pull/5368

CEON URI Mapping users (and some non-users as well) who get logs relating to TOPMOST_CATEGORY_PARENT_ID will need this patch:

https://github.com/zencart/zencart/pull/5371

PayPal Pro gives a white screen at checkout.

(This can also happen with any other onsite payment method that uses AJAX.)

Fix here: https://github.com/zencart/zencart/pull/5413

See warning in post #9 about additional files required for PayPal.

Please note: if you pick up any of the includes/modules/payment/paypal*.php files to fix a PHP warning or notice, you MUST also pick up the new file

./includes/modules/payment/paypal/paypal_currency_check.php

The following functions were renamed in 1.5.8 without warning

• zen_draw_products_pull_down
• zen_draw_products_pull_down_attributes
• zen_draw_products_pull_down_categories
• zen_draw_products_pull_down_categories_attributes
• zen_get_orders_status

The next release will alias the old names along with a deprecation notice so upgraders will have an easier time of fixing their code.

See

https://github.com/zencart/zencart/pull/5439/files

The links in the Orders dashboard widget on the home page (that go to the orders page, filtered by the selected status) don't filter correctly.

Fix:
https://github.com/zencart/zencart/pull/5440

Transaction ID missing from PayPal email.

Fix: https://github.com/zencart/zencart/pull/5464/files

See warning in post #9 about additional files required for PayPal.

If you need to use mysqli or access the link variable in the database class, please apply this PR:

https://github.com/zencart/zencart/pull/5486

Admin pages with numeric dropdowns that provide pagination (page 1, 2, ... n) such as catalog > categories/products and catalog > option name manager do not work in 1.5.8; please apply this fix:

https://github.com/zencart/zencart/pull/5608/files

AuthorizeNet AIM requires this fix:

https://github.com/zencart/zencart/pull/5653/files

Product descriptions are not appearing in various places when they should be (listing pages, etc.)

You need this fix:
https://github.com/zencart/zencart/commit/e2007b971c320307405e9bb291e1edf57cb5b757

All above listed bugs and many others are fixed in the Zen Cart 1.5.8a release.
You may download 1.5.8a here: https://github.com/zencart/zencart/releases

Admin > Catalog > Manufacturers does not show Insert button when list of manufacturers is empty (i.e. Initially).

Fix https://github.com/zencart/zencart/pull/5703/files

This was fixed in 1.5.8a.

Rare but possible: customers_default_address_id values in the customers table can get clobbered.

If you are running Zen Cart 1.5.8 or 1.5.8a, you should apply this patch to your system:

https://github.com/zencart/zencart/pull/5687/files

Special thanks to Zen Cart user and developer @marco-pm for cracking this bug.

Upgrading an old database with paypaldp and going to PHP 8.2 - it's possible that you may get this error:

PHP Fatal error: Uncaught Error: Undefined constant "MODULE_PAYMENT_PAYPALDP_MERCHANT_COUNTRY"

/home/YOURACCOUNT/public_html/includes/modules/payment/paypaldp.php:264

If this happens, simply go to Admin > Modules > Payment and visit the PayPal configuration page to fix it.

This issue is fixed in Zen Cart 2.0.0 via https://github.com/zencart/zencart/pull/6144/files ... which is safe to apply to your v1.5.8 site too.