Skip to content

Document prestashop:assets:symlinks command and shop migration - #2168

Open
PrestaEdit wants to merge 1 commit into
PrestaShop:9.xfrom
PrestaEdit:feat/assets-symlinks-command-doc
Open

PrestaEdit wants to merge 1 commit into
PrestaShop:9.xfrom
PrestaEdit:feat/assets-symlinks-command-doc

Conversation

@PrestaEdit

Copy link
Copy Markdown
Contributor
Questions Answers
Branch? 9.x
Description? Documents the new prestashop:assets:symlinks command and adds a broader how-to on moving a PrestaShop installation. See details below.
Fixed ticket? —
Sponsor company —

What this PR adds

Two new pages:

development/components/console/prestashop-assets-symlinks.md

Reference page for the new prestashop:assets:symlinks command (see related core PR below). Matches the format of the other command pages under development/components/console/ (Informations / Description / Examples), and documents both the detect and --fix modes.

basics/deployment/moving-installation.md

A how-to page that walks through the full checklist for moving a PrestaShop installation:

  1. Update ps_shop_url and ps_configuration (domain + SSL domain).
  2. Clear caches.
  3. Regenerate .htaccess via prestashop:htaccess:generate --force.
  4. Repair public bundle symlinks via the new prestashop:assets:symlinks --fix.
  5. Reinstall Composer dependencies when the shop was copied to another server.
  6. Purge active sessions so customers don't hit invalid cookies.

Plus a "Known limitations" section warning about modules and CMS content that store absolute URLs.

The basics/deployment/ section previously only contained "Creating your own distribution", which does not cover this case at all. The step-by-step is deliberately practical — it links out to the two dedicated command pages rather than duplicating their content.

Related PR

Core: PrestaShop/PrestaShop#42947 (adds the prestashop:assets:symlinks command that this documentation refers to).

This PR can be merged independently once the core PR is accepted and its command name is confirmed. If the core PR ends up renaming the command, this PR needs a rename pass — nothing structural.

🤖 Generated with Claude Code

Adds two pages:

- development/components/console/prestashop-assets-symlinks.md:
  reference page for the new command, matching the style of the
  other console command pages.

- basics/deployment/moving-installation.md: a how-to that walks
  through the six steps of moving a PrestaShop installation
  (database, cache, .htaccess, bundle symlinks, autoload, sessions)
  and warns about modules and uploaded content that store absolute
  URLs. The section previously only covered building your own
  distribution.

Related core PR: PrestaShop/PrestaShop#42947

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
@github-actions github-actions Bot added the 9.x label Sep 22, 2026
@PrestaEdit
PrestaEdit marked this pull request as ready for review September 22, 2026 09:09

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant