Hantera tillägg från tredje part
Kod som utökar eller anpassar Adobe Commerce-beteendet kallas ett tillägg. Du kan även paketera och distribuera tillägg på Commerce Marketplace eller något annat tilläggsdistributionssystem.
Tilläggen omfattar:
- Moduler (utöka Adobe Commerce funktioner)
- Teman (ändra utseende och känsla för din butik och administratör)
- Språkpaket (lokalisera butiken och administratören)
composer.json
-fil och noterar värdena för "name"
och "version"
.Installera
Före installationen kanske du vill:
-
Säkerhetskopiera databasen.
-
Aktivera underhållsläge:
code language-bash bin/magento maintenance:enable
Om du vill installera ett tillägg måste du:
-
Få ett tillägg från Commerce Marketplace eller en annan tilläggsutvecklare.
-
Om du installerar ett tillägg från Commerce Marketplace måste du kontrollera att databasen
repo.magento.com
finns i dincomposer.json
-fil:code language-bash "repositories": [ { "type": "composer", "url": "https://repo.magento.com/" } ]
-
Hämta tilläggets dispositionsnamn och version.
-
Uppdatera filen
composer.json
i ditt projekt med tilläggets namn och version. -
Kontrollera att tillägget har installerats korrekt.
-
Aktivera och konfigurera tillägget.
Hämta tilläggsinformation
Om du redan känner till tilläggets dispositionsnamn och version hoppar du över det här steget och fortsätter med Uppdatera composer.json
-filen.
Så här hämtar du tilläggets dispositionsnamn och version från Commerce Marketplace:
-
Logga in på Commerce Marketplace med det användarnamn och lösenord som du använde för att köpa tillägget.
-
Klicka på Ditt namn > Min profil i det övre högra hörnet.
-
Klicka på Mina köp.
-
Hitta det tillägg som du vill installera och klicka på Teknisk information.
composer.json
-fil.Uppdatera Composer-beroenden
Lägg till tilläggets namn och version i din composer.json
-fil:
-
Navigera till din projektkatalog och uppdatera
composer.json
-filen.code language-bash composer require <component-name>:<version>
Exempel:
code language-bash composer require j2t/module-payplug:2.0.2
-
Ange dina autentiseringsnycklar. Din offentliga nyckel är ditt användarnamn. Din privata nyckel är ditt lösenord.
-
Vänta tills Composer har uppdaterat dina projektberoenden och kontrollera att inga fel uppstår:
code language-none Updating dependencies (including require-dev) Package operations: 1 install, 0 updates, 0 removals - Installing j2t/module-payplug (2.0.2): Downloading (100%) Writing lock file Generating autoload files
Verifiera installation
Kör följande kommando för att kontrollera att tillägget är korrekt installerat:
bin/magento module:status J2t_Payplug
Tillägget är antagligen inaktiverat som standard:
Module is disabled
Tilläggsnamnet har formatet <VendorName>_<ComponentName>
. Det är ett annat format än Composer-namnet. Använd det här formatet om du vill aktivera tillägget. Om du är osäker på tilläggets namn kör du:
bin/magento module:status
Och sök efter tillägget under"Lista över inaktiverade moduler".
Aktivera
Vissa tillägg fungerar inte korrekt om du inte först rensar genererade statiska vyfiler. Använd alternativet --clear-static-content
för att rensa statiska vyfiler när du aktiverar ett tillägg.
-
Aktivera tillägget och rensa statiska visningsfiler:
code language-bash bin/magento module:enable J2t_Payplug --clear-static-content
Följande utdata bör visas:
code language-none The following modules have been enabled: - J2t_Payplug To make sure that the enabled modules are properly registered, run 'setup:upgrade'. Cache cleared successfully. Generated classes cleared successfully. Please run the 'setup:di:compile' command to generate classes. Generated static view files cleared successfully.
-
Registrera tillägget:
code language-bash bin/magento setup:upgrade
-
Kompilera om ditt projekt: I produktionsläget kan du få ett meddelande om att köra kompileringskommandot för Magento igen. Du uppmanas inte att köra kompileringskommandot i utvecklarläget.
code language-bash bin/magento setup:di:compile
-
Kontrollera att tillägget är aktiverat:
code language-bash bin/magento module:status J2t_Payplug
Du bör se utdata som verifierar att tillägget inte längre är inaktiverat:
code language-none Module is enabled
-
Rensa cachen:
code language-bash bin/magento cache:clean
-
Konfigurera tillägget i Admin efter behov.
bin/magento cache:flush
.Uppgradera
Så här uppdaterar eller uppgraderar du en modul eller ett tillägg:
-
Hämta den uppdaterade filen från Marketplace eller någon annan tilläggsutvecklare. Notera modulens namn och version.
-
Exportera innehållet till programmets rotkatalog.
-
Om det finns ett Composer-paket för modulen kör du något av följande.
Uppdatering per modulnamn:
code language-bash composer update vendor/module-name
Uppdatering per version:
code language-bash composer require vendor/module-name ^x.x.x
-
Kör följande kommandon för att uppgradera, distribuera och rensa cachen.
code language-bash bin/magento setup:upgrade --keep-generated
code language-bash bin/magento setup:static-content:deploy
code language-bash bin/magento cache:clean
Avinstallera
Du bör kontakta tilläggsleverantören för instruktioner om hur du tar bort ett tillägg från tredje part. Instruktionerna ska innehålla följande information:
- Återställa ändringar i databastabellen
- Återställa databasdataändringar
- Vilka filer som ska tas bort eller återställas
Följande instruktioner innehåller allmän information om hur du avinstallerar tillägg från tredje part:
-
Ta bort tillägget från Adobe Commerce projektarkiv.
-
För Composer-baserade tillägg tar du bort tillägget från Adobe Commerce
composer.json
-filen.code language-bash composer remove <package-name>
-
För icke-dispositionsbaserade tillägg tar du bort de fysiska filerna från Adobe Commerce projektdatabas.
code language-bash rm -rf app/code/<vendor-name>/<module-name>
-
-
Om filen
config.php
ligger under källkontroll i Adobe Commerce projektdatabas tar du bort tillägget från filenconfig.php
. -
Testa den lokala databasen för att säkerställa att leverantörens instruktioner fungerar som förväntat.
-
Kontrollera att tillägget är korrekt inaktiverat och att webbplatsen fungerar som förväntat i staging-miljön.
-
Driftsätt ändringarna i produktionsmiljön.