Custom product URL

Instructions for Custom product URL

What the add-on does

Version 1.0.0 provides a shared product URL prefix setting and depends on the standard SEO add-on. In the current code, the saved prefix is not connected to link generation. The steps below therefore describe the available field and package limitations, not a guaranteed URL change procedure.

Where to find the add-on

Open “Custom product URL” in the add-on management area. The “Enter a prefix for the product URL” field is in the main settings section. The add-on does not add a separate bulk URL update page or per-product settings.

Configuring the prefix

1. Record the current value of “Enter a prefix for the product URL”.
2. Enter the intended prefix. The default is product; this is prefix text, not a complete store address.
3. Save the settings, reopen the add-on page and check the saved value.

Saving the field does not trigger URL changes. The code contains no handling of this value, empty-prefix behavior or character normalization. Do not assume that an empty field removes a URL segment or that any entered string will automatically become a valid URL.

Current version limitations

• The prod_url setting is declared but is not read by the URL modification logic.
• A separate fn_update_seo_names() function exists, but no call connects it to saving settings, processing a product or a user-facing button. Do not invoke it manually as a way to apply the setting.
• This function selects product SEO records with company_id = 1 and adds the fixed path element 12345/ when the path does not already contain the string 12345. It does not use the entered prefix.
• The update inside the function is restricted by object and company IDs, but not by object type or language. It cannot be treated as a safe selective operation on products in the current language or storefront.
• The installation migration adds a category-type SEO record named product, with object ID 12345, company 1 and language ru. This does not confirm that a corresponding category exists or configure other languages or companies.
• Automatic 301 redirect creation is not implemented. The reverse migration contains no data restoration steps.

How to check the result

1. Check this package on a test copy of the store with the standard SEO add-on. Back up the database and record several original product links before any work on SEO data.
2. Change the prefix in the add-on settings and confirm that the value persists after reopening the page.
3. Open the same products from the storefront catalog and compare their links with the originals. With the current code, changing the field must not be treated as a completed URL migration.
4. If actual URL changes are required, ask a developer to connect the setting to link generation, define the processing scope and handle old URLs.
5. After that work, check new links, old URL behavior, the absence of 404 errors and correct navigation for every language and storefront in use.

If the value is saved but the URLs do not change, this matches the current version’s identified limitation. Reinstalling the add-on or manually running the bulk function is not a substitute for completing the implementation. Restoring the previous setting does not restore SEO data that was changed manually either.