Hantera tillägg
Du kan utöka dina Adobe Commerce-programfunktioner genom att lägga till ett tillägg från Commerce Marketplace. Du kan till exempel lägga till ett tema för att ändra utseendet på din butik eller lägga till ett språkpaket för att lokalisera din butik och administratör.
Kompositörens namn för ett tillägg
I det här avsnittet beskrivs hur du hämtar Composer-namnet och versionen av ett tillägg från Commerce Marketplace, men du hittar namnet och versionen på any-modulen i modulens Composer-fil. Öppna filen composer.json
i en textredigerare och notera värdena "name"
och "version"
.
Så här hämtar du dispositionsnamnet för en modul 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 komponenten.
-
Klicka på ditt användarnamn i det övre högra hörnet och välj Min profil.
-
Klicka på Mina köp på sidan Mitt konto.
-
På sidan Mina inköp väljer du en modul som du har köpt och klickar på Teknisk information.
-
Klicka på Kopiera om du vill kopiera Component name till Urklipp.
-
Öppna en textredigerare och klistra in komponentnamnet och lägg till ett kolontecken (
:
). -
I teknisk information klickar du på Kopiera för att kopiera Component version till Urklipp.
-
Lägg till versionsnumret i komponentnamnet efter kolonet i textredigeraren. Exempel:
code language-text extension-name/magento2:1.0.1
Installera ett tillägg
Adobe rekommenderar att du arbetar i en utvecklingsgren när du lägger till ett tillägg till implementeringen. När du installerar ett tillägg infogas tilläggets namn (<VendorName>_<ComponentName>
) automatiskt i filen app/etc/config.php
. Du behöver inte redigera filen direkt.
Så här installerar du ett tillägg:
-
Byt till din projektkatalog på din lokala arbetsstation.
-
Skapa eller checka ut en utvecklingsgren. Se förgreningar.
-
Använd Composer-namnet och -versionen för att lägga till tillägget i
require
-delen av filencomposer.json
.code language-bash composer require <extension-name>:<version> --no-update
-
Uppdatera projektberoenden.
code language-bash composer update
-
Lägg till, implementera och push-ändra kod.
code language-bash git add -A
code language-bash git commit -m "Install <extension-name>"
code language-bash git push origin <branch-name>
note warning WARNING När du installerar ett tillägg måste du inkludera filen composer.lock
när du skickar kodändringar till fjärrmiljön. Kommandotcomposer install
läser filencomposer.lock
för att aktivera definierade beroenden i fjärrmiljön. -
När bygget och distributionen är klar loggar du in på fjärrmiljön med en SSH och kontrollerar att tillägget är installerat.
code language-bash bin/magento module:status <extension-name>
Ett tilläggsnamn har formatet
<VendorName>_<ComponentName>
.Exempelsvar:
code language-none Module is enabled
Om du råkar ut för distributionsfel läser du distributionsfel för tillägg.
Hantera tillägg
När du lägger till ett tillägg med Composer aktiveras tillägget automatiskt av distributionsprocessen. Om du redan har installerat tillägget kan du aktivera eller inaktivera det med CLI. Använd formatet <VendorName>_<ComponentName>
när du hanterar tillägg.
Aktivera eller inaktivera aldrig ett tillägg när du är inloggad i fjärrmiljöer.
Så här aktiverar eller inaktiverar du ett tillägg:
-
Byt till din projektkatalog på din lokala arbetsstation.
-
Aktivera eller inaktivera en modul. Kommandot
module
uppdaterar filenconfig.php
med den begärda statusen för modulen.Aktivera en modul.
code language-bash bin/magento module:enable <module-name>
Inaktivera en modul.
code language-bash bin/magento module:disable <module-name>
-
Om du har aktiverat en modul använder du
ece-tools
för att uppdatera konfigurationen.code language-bash ./vendor/bin/ece-tools module:refresh
-
Verifiera statusen för en modul.
code language-bash bin/magento module:status <module-name>
-
Lägg till, implementera och push-ändra kod.
code language-bash git add -A
code language-bash git commit -m "Disable <extension-name>"
code language-bash git push origin <branch-names>
Uppgradera ett tillägg
Innan du fortsätter behöver du namnet och versionen för dispositionen. Bekräfta också att tillägget är kompatibelt med ditt projekt och Adobe Commerce-versionen. Kontrollera den PHP-version som krävs innan du börjar.
Så här uppdaterar du ett tillägg:
-
Byt till din projektkatalog på din lokala arbetsstation.
-
Skapa eller checka ut en utvecklingsgren. Se förgreningar.
-
Öppna filen
composer.json
i en textredigerare. -
Leta reda på tillägget och uppdatera versionen.
-
Spara ändringarna och avsluta textredigeraren.
-
Uppdatera projektberoenden.
code language-bash composer update
-
Lägg till, implementera och push-överföra kodändringar.
code language-bash git add -A
code language-bash git commit -m "Update <extension-name>"
code language-bash git push origin <branch-names>
Om du råkar ut för fel kan du läsa Återställa från komponentfel. Mer information om hur du använder tillägg med Adobe Commerce finns i Tillägg i Admin Guide.