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.

NOTE
För att undvika installationsproblem måste alla Marketplace-inköp slutföras med samma konto (MAGEID) som äger molnprojektet.

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:

  1. Logga in på Commerce Marketplace med det användarnamn och lösenord som du använde för att köpa komponenten.

  2. Klicka på ditt användarnamn i det övre högra hörnet och välj Min profil.

    Gå till ditt Marketplace-konto

  3. Klicka på Mina köp på sidan Mitt konto.

    Marketplace, inköpshistorik

  4. På sidan Mina inköp väljer du en modul som du har köpt och klickar på Teknisk information.

  5. Klicka på Kopiera om du vill kopiera Component name till Urklipp.

  6. Öppna en textredigerare och klistra in komponentnamnet och lägg till ett kolontecken (:).

  7. I teknisk information klickar du på Kopiera för att kopiera Component version till Urklipp.

  8. 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:

  1. Byt till din projektkatalog på din lokala arbetsstation.

  2. Skapa eller checka ut en utvecklingsgren. Se förgreningar.

  3. Använd Composer-namnet och -versionen för att lägga till tillägget i require-delen av filen composer.json.

    code language-bash
    composer require <extension-name>:<version> --no-update
    
  4. Uppdatera projektberoenden.

    code language-bash
    composer update
    
  5. 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. Kommandot composer install läser filen composer.lock för att aktivera definierade beroenden i fjärrmiljön.
  6. 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:

  1. Byt till din projektkatalog på din lokala arbetsstation.

  2. Aktivera eller inaktivera en modul. Kommandot module uppdaterar filen config.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>
    
  3. 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
    
  4. Verifiera statusen för en modul.

    code language-bash
    bin/magento module:status <module-name>
    
  5. 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:

  1. Byt till din projektkatalog på din lokala arbetsstation.

  2. Skapa eller checka ut en utvecklingsgren. Se förgreningar.

  3. Öppna filen composer.json i en textredigerare.

  4. Leta reda på tillägget och uppdatera versionen.

  5. Spara ändringarna och avsluta textredigeraren.

  6. Uppdatera projektberoenden.

    code language-bash
    composer update
    
  7. 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.

recommendation-more-help
05f2f56e-ac5d-4931-8cdb-764e60e16f26