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)
TIP
I det här avsnittet beskrivs hur du använder kommandoradsgränssnittet för att hantera tillägg från tredje part som du köper från Commerce Marketplace. Du kan använda samma procedur för att installera valfritt-tillägg. Allt du behöver är tilläggets Composer-namn och version. Om du vill hitta den öppnar du tilläggets composer.json-fil och noterar värdena för "name" och "version".

Installera

Före installationen kanske du vill:

  1. Säkerhetskopiera databasen.

  2. Aktivera underhållsläge:

    code language-bash
    bin/magento maintenance:enable
    

Om du vill installera ett tillägg måste du:

  1. Få ett tillägg från Commerce Marketplace eller en annan tilläggsutvecklare.

  2. Om du installerar ett tillägg från Commerce Marketplace måste du kontrollera att databasen repo.magento.com finns i din composer.json-fil:

    code language-bash
    "repositories": [
        {
            "type": "composer",
            "url": "https://repo.magento.com/"
        }
    ]
    
  3. Hämta tilläggets dispositionsnamn och version.

  4. Uppdatera filen composer.json i ditt projekt med tilläggets namn och version.

  5. Kontrollera att tillägget har installerats korrekt.

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

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

  2. Klicka på Ditt namn > Min profil i det övre högra hörnet.

    Gå till ditt Marketplace-konto

  3. Klicka på Mina köp.

    Marketplace, inköpshistorik

  4. Hitta det tillägg som du vill installera och klicka på Teknisk information.

    Teknisk information visar tilläggets disposition

TIP
Du kan också hitta Composer-namnet och versionen av tillägget any (oavsett om du har köpt det på Commerce Marketplace eller någon annanstans) i tilläggets composer.json-fil.

Uppdatera Composer-beroenden

Lägg till tilläggets namn och version i din composer.json-fil:

  1. 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
    
  2. Ange dina autentiseringsnycklar. Din offentliga nyckel är ditt användarnamn. Din privata nyckel är ditt lösenord.

  3. 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.

  1. 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.
    
  2. Registrera tillägget:

    code language-bash
    bin/magento setup:upgrade
    
  3. 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
    
  4. 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
    
  5. Rensa cachen:

    code language-bash
    bin/magento cache:clean
    
  6. Konfigurera tillägget i Admin efter behov.

TIP
Om du får problem när du läser in butiken i en webbläsare använder du följande kommando för att rensa cachen: bin/magento cache:flush.

Uppgradera

Så här uppdaterar eller uppgraderar du en modul eller ett tillägg:

  1. Hämta den uppdaterade filen från Marketplace eller någon annan tilläggsutvecklare. Notera modulens namn och version.

  2. Exportera innehållet till programmets rotkatalog.

  3. 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
    
  4. 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
CAUTION
Utför avinstallationssteg i en icke-produktionsmiljö först och testa noga innan du distribuerar till produktionsmiljön.

Följande instruktioner innehåller allmän information om hur du avinstallerar tillägg från tredje part:

  1. 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>
      
  2. Om filen config.php ligger under källkontroll i Adobe Commerce projektdatabas tar du bort tillägget från filen config.php.

  3. Testa den lokala databasen för att säkerställa att leverantörens instruktioner fungerar som förväntat.

  4. Kontrollera att tillägget är korrekt inaktiverat och att webbplatsen fungerar som förväntat i staging-miljön.

  5. Driftsätt ändringarna i produktionsmiljön.

recommendation-more-help
0f8e7db5-0e9c-4002-a5b8-a0088077d995