Een extensie installeren

Code die het gedrag Adobe Commerce uitbreidt of aanpast, wordt een extensie genoemd. U kunt desgewenst extensies verpakken en distribueren op het tabblad Commerce Marketplace of een ander extensiedistributiesysteem.

Extensies zijn:

  • Modules (breid Adobe Commerce- en Magento Open Source-mogelijkheden uit)
  • Thema's (wijzig de vormgeving van uw storefront en beheerder)
  • Taalpakketten (lokaliseer de winkel en Admin)
TIP

Dit onderwerp verklaart hoe te om de bevellijn te gebruiken om uitbreidingen te installeren u van de Commerce Marketplace koopt. U kunt dezelfde procedure gebruiken om te installeren alle uitbreiding; alleen de extensie Composer naam en versie. Open de extensies om deze te zoeken composer.json en noteer de waarden voor "name" en "version".

Voordat u gaat installeren, kunt u het volgende doen:

  1. Maak een back-up van uw database.

  2. Onderhoudsmodus inschakelen:

    bin/magento maintenance:enable
    

Als u een extensie wilt installeren, moet u:

  1. Haal een extensie op van de Commerce Marketplace of een andere extensieontwikkelaar.

  2. Als u een extensie van de Commerce Marketplace installeert, moet u ervoor zorgen dat de extensie repo.magento.com de opslagplaats bestaat in uw composer.json bestand:

    "repositories": [
        {
            "type": "composer",
            "url": "https://repo.magento.com/"
        }
    ]
    
  3. Haal de Composer-naam en -versie van de extensie op.

  4. Werk de composer.json in uw project met de naam en de versie van de extensie.

  5. Controleer of de extensie correct is geïnstalleerd.

  6. De extensie inschakelen en configureren.

De naam en versie van de extensiecomposer ophalen

Als u de Composer-naam en -versie van de extensie al kent, slaat u deze stap over en gaat u verder met Werk uw composer.json file.

De naam en versie van de componist van de extensie ophalen uit de Commerce Marketplace:

  1. Aanmelden bij Commerce Marketplace met de gebruikersnaam en het wachtwoord waarmee u de extensie hebt aangeschaft.

  2. Klik in de rechterbovenhoek op Uw naam > Mijn profiel.

    Toegang tot uw Marketplace-account

  3. Klikken Mijn aankopen.

    Aankoopgeschiedenis van Marketplace

  4. Zoek de extensie die u wilt installeren en klik op Technische details.

    De technische details tonen de Composer naam van de uitbreiding

TIP

U kunt ook de naam en versie van de Composer vinden van alle extensie (aangeschaft op Commerce Marketplace of ergens anders) in de extensie composer.json bestand.

Uw Composer-bestand bijwerken

De naam en versie van de extensie toevoegen aan uw composer.json bestand:

  1. Navigeer naar de projectmap en werk de projectmap bij composer.json bestand.

    composer require <component-name>:<version>
    

    Bijvoorbeeld:

    composer require j2t/module-payplug:2.0.2
    
  2. Voer uw verificatietoetsen. Uw openbare sleutel is uw gebruikersnaam; uw persoonlijke sleutel is uw wachtwoord.

  3. Wacht op Composer om het bijwerken van uw projectgebiedsdelen te voltooien en ervoor te zorgen dat er geen fouten zijn:

    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
    

De extensie verifiëren

Voer de volgende opdracht uit om te controleren of de extensie correct is geïnstalleerd:

bin/magento module:status J2t_Payplug

Standaard is de extensie waarschijnlijk uitgeschakeld:

Module is disabled

De extensienaam heeft de notatie <VendorName>_<ComponentName>; Dit is een andere indeling dan de naam van de componist. Gebruik deze indeling om de extensie in te schakelen. Voer de volgende handelingen uit als u niet zeker bent van de extensienaam:

bin/magento module:status

En zoek de extensie onder "Lijst met uitgeschakelde modules".

De extensie inschakelen

Sommige extensies werken alleen correct als u gegenereerde statische weergavebestanden wist. Gebruik de --clear-static-content om statische weergavebestanden te wissen wanneer u een extensie inschakelt.

  1. De extensie inschakelen en statische weergavebestanden wissen:

    bin/magento module:enable J2t_Payplug --clear-static-content
    

    De volgende uitvoer wordt weergegeven:

    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. De extensie registreren:

    bin/magento setup:upgrade
    
  3. Uw project opnieuw compileren: In de productiemodus ontvangt u mogelijk het bericht "Voer de opdracht Magento opnieuw samen". De toepassing vraagt u niet om het compileerbevel op de wijze van de Ontwikkelaar in werking te stellen.

    bin/magento setup:di:compile
    
  4. Controleer of de extensie is ingeschakeld:

    bin/magento module:status J2t_Payplug
    

    De uitvoer moet controleren of de extensie niet meer is uitgeschakeld:

    Module is enabled
    
  5. De cache reinigen:

    bin/magento cache:clean
    
  6. Configureer de extensie naar wens in Admin.

TIP

Als u fouten tegenkomt bij het laden van de storefront in een browser, gebruikt u de volgende opdracht om de cache te wissen: bin/magento cache:flush.

Een extensie upgraden

Een module of extensie bijwerken of bijwerken:

  1. Download het bijgewerkte bestand van Marketplace of een andere ontwikkelaar van extensies. Noteer de modulenaam en -versie.

  2. Exporteer de inhoud naar de hoofdmap van de toepassing.

  3. Voer een van de volgende handelingen uit als er een Composer-pakket voor de module bestaat.

    Bijwerken per modulenaam:

    composer update vendor/module-name
    

    Bijwerken per versie:

    composer require vendor/module-name ^x.x.x
    
  4. Voer de volgende opdrachten uit om de cache te upgraden, te implementeren en schoon te maken.

    bin/magento setup:upgrade --keep-generated
    
    bin/magento setup:static-content:deploy
    
    bin/magento cache:clean
    

Op deze pagina