Open ts-mothership opened 7 months ago
feel free to make a PR to improve the docs :)
@ts-mothership I think there a too many issues in this ticket, can please split this ticket up? The incompatibility of shopware-cli project dump
with the current versions of SW is for example a topic for it's own.
@andreasemer First things first, the documentation should be updated first to make clear how it should work. Not everything is clear until now, maybe shyim first can clarify the intensions and use-cases for the commands listed above.
To the "project dump": it still works, there is no error if old tables are missing so I wouldn't consider it a bug but a missing feature. And this is more a documentation issue than anything else.
I will look how when I have time for this. I want to do a lot of more until the SCD. I will present shopware-cli on the Community Stage at the SCD
If this becomes an official tool, I bet we can give support here docs-wise.
Only played around with it so far, but never used in "production" - I am curious :)
Question
Abstract
The shopware-cli command is more or less a blackbox. The current version of the documentation on https://sw-cli.fos.gg/ mostly lists only the different commands but does not explain the reasons why different arguments are needed, how it internally works and what to do on certain use cases and errors. There should be more information given, more examples and explanation.
I checked a few commands and it was not always clear why it didn't work as expected. Only after deep diving into the source code I understood more concepts of different commands, but not always. I know documentation is not easy but I'll try to list the questionable commands here and try to suggest something if possible or ask specific questions. Commands not listed below are fine for me 👍 .
shopware-cli project admin-build
project admin-build
vs bin/build-administration.sh?shopware-cli project storefront-build
shopware-cli project worker
bin/console messenger:consume
command?shopware-cli project dump
--clean
does not contain SW 6.5 table "messenger_messages". Maybe include also other core tables likeimport_export_log
. Also update all rows in tablescheduled_task
tostatus='scheduled'
to make sure they're not hanging in status "queued" because you clean the queue table.--anonymize
should change/remove password and legacy password fields as welluser
from anonymization?shopware-cli project extension *
project worker
works from home directory?project extension
commands andextension
commands in documentation and use cases for bothshopware-cli project generate-jwt
bin/console system:generate-jwt-secret
command?shopware-cli extension validate
Required field "previewMedia" in theme.json is not in
ends abruptly, seems there should be something after "in"shopware-cli extension build
shopware-cli extension admin-watch
shopware-cli project admin-watch
?shopware-cli extension get-changelog
SHOPWARE_PROJECT_ROOT=$( pwd ) shopware-cli extension get-changelog vendor/store.shopware.com/swagsocialshopping
when I just cancat vendor/store.shopware.com/swagsocialshopping/CHANGELOG.md
?get-changelog
command fetches only the latest version and parses it into HTML, which doesn't make sense in terminal. What are the reasons behind it?--german
I suggest changing it to--locale de-DE
to make it future prove for other languagesshopware-cli extension get-version