DocumentatieCommerceInstallatiehandleiding

Extensies van derden beheren

Last update: Mon Nov 04 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Onderwerpen:

Gemaakt voor:

  • Ervaren
  • Beheerder
  • Ontwikkelaar

Code die het gedrag van Adobe Commerce uitbreidt of aanpast, wordt een extensie genoemd. U kunt naar keuze uitbreidingen op de Commerce Marketplaceof een ander systeem van de uitbreidingsdistributie verpakken en verdelen.

Extensies zijn:

  • Modules (Adobe Commerce-mogelijkheden uitbreiden)
  • Thema's (wijzig de vormgeving van uw winkel en Admin)
  • Taalpakketten (lokaliseer de winkel en Admin)

Dit onderwerp verklaart hoe te om de bevel-lijn interface te gebruiken om derdeuitbreidingen te beheren die u van de Commerce Marketplace voor op-gebouw projecten koopt. Voor de projecten van de wolkeninfrastructuur, zie uitbreidingenbeheren.

U kunt de zelfde procedure gebruiken om om het even welke uitbreiding te installeren; allen u hebt nodig is de naam en de versie van Composer van de uitbreiding. Als u de extensie wilt zoeken, opent u het composer.json -bestand en noteert u de waarden voor "name" en "version" .

Installeren

Voordat u gaat installeren, kunt u het volgende doen:

  1. Maak een back-up van uw database.

  2. Onderhoudsmodus inschakelen:

    code language-bash 
    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 installeert vanuit de Commerce Marketplace, moet u ervoor zorgen dat de repo.magento.com -opslagplaats bestaat in uw composer.json -bestand:

    code language-bash 
    "repositories": [
    {
        "type": "composer",
        "url": "https://repo.magento.com/"
    }
]

  3. Haal de Composer-naam en -versie van de extensie op.

  4. Werk het composer.json dossier in uw project met de naam en de versie van de uitbreiding bij.

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

  6. De extensie inschakelen en configureren.

Extensiegegevens ophalen

Als u reeds de naam en de versie van Composer van de uitbreiding kent, sla deze stap over en ga met verder werk uw composer.json dossierbij.

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

  1. Login aan Commerce Marketplacemet de gebruikersbenaming en het wachtwoord u gebruikte om de uitbreiding te kopen.

  2. In de hoger-juiste hoek, klik Uw naam > Mijn Profiel.

    heb toegang tot uw rekening van de Marketplace

  3. Klik Mijn Aankopen.

    de aankoopgeschiedenis van de Marketplace

  4. Zoek de extensie die u wilt installeren en noteer de naam en versie van de component.

    Technische details tonen de naam van Composer van de uitbreiding

TIP
Alternatief, kunt u de naam en de versie van Composer van vinden om het even welke uitbreiding (of u het op Commerce Marketplace of elders) in het dossier van de uitbreiding composer.json kocht.

Composerafhankelijkheden bijwerken

Voeg de naam en de versie van de extensie toe aan het composer.json -bestand:

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

    code language-bash 
    composer require <component-name>:<version>

    Bijvoorbeeld:

    code language-bash 
    composer require j2t/module-payplug:2.0.2

  2. Ga uw authentificatietoetsenin. 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:

    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

Installatie controleren

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 naam van de extensie heeft de indeling <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 naam van de extensie:

bin/magento module:status

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

Inschakelen

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

  1. De extensie inschakelen en statische weergavebestanden wissen:

    code language-bash 
    bin/magento module:enable J2t_Payplug --clear-static-content

    U zou de volgende output moeten zien:

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

    code language-bash 
    bin/magento setup:upgrade

  3. Uw project opnieuw compileren: in de productiemodus ontvangt u mogelijk het bericht "Voer de compilatieopdracht van het Magento opnieuw uit". De toepassing vraagt u niet om het compileerbevel op de wijze van de Ontwikkelaar in werking te stellen.

    code language-bash 
    bin/magento setup:di:compile

  4. Controleer of de extensie is ingeschakeld:

    code language-bash 
    bin/magento module:status J2t_Payplug

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

    code language-none 
    Module is enabled

  5. De cache reinigen:

    code language-bash 
    bin/magento cache:clean

  6. Configureer de extensie naar wens in Admin.

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

Upgrade

Een module of extensie bijwerken of bijwerken:

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

  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:

    code language-bash 
    composer update vendor/module-name

    Bijwerken per versie:

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

    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

Verwijderen

Neem contact op met de leverancier van extensies voor instructies om een extensie van een andere fabrikant te verwijderen. De instructies moeten de volgende informatie bevatten:

  • Hoe te om de veranderingen van de gegevensbestandlijst terug te keren
  • Hoe te om de veranderingen van gegevensbestandgegevens terug te keren
  • Welke bestanden moeten worden verwijderd of teruggezet
CAUTION
Voer desinstallatiestappen op een non-production milieu eerst uit en test grondig alvorens aan uw productiemilieu op te stellen.

De volgende instructies bevatten algemene informatie voor het verwijderen van extensies van derden:

  1. Verwijder de extensie uit de Adobe Commerce-projectopslagplaats.

    • Voor op Composer gebaseerde extensies verwijdert u de extensie uit het Adobe Commerce composer.json -bestand.

      code language-bash 
      composer remove <component-name>

    • Voor extensies die niet op Composer zijn gebaseerd, verwijdert u de fysieke bestanden uit de Adobe Commerce-projectopslagplaats.

      code language-bash 
      rm -rf app/code/<vendor-name>/<component-name>

  2. Als het config.php -bestand zich onder bronbeheer in uw Adobe Commerce-projectopslagplaats bevindt, verwijdert u de extensie uit het config.php -bestand.

  3. Test uw lokale gegevensbestand om ervoor te zorgen dat de verkoper-geleverde instructies zoals verwacht werken.

  4. Controleer of de extensie correct is uitgeschakeld en of uw website naar behoren werkt in uw testomgeving.

  5. Implementeer de wijzigingen in uw productieomgeving.

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