Extensies van derden beheren
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)
composer.json
-bestand en noteert u de waarden voor "name"
en "version"
.Installeren
Voordat u gaat installeren, kunt u het volgende doen:
-
Maak een back-up van uw database.
-
Onderhoudsmodus inschakelen:
code language-bash bin/magento maintenance:enable
Als u een extensie wilt installeren, moet u:
-
Haal een extensie op van de Commerce Marketplace of een andere extensieontwikkelaar.
-
Als u een extensie installeert vanuit de Commerce Marketplace, moet u ervoor zorgen dat de
repo.magento.com
-opslagplaats bestaat in uwcomposer.json
-bestand:code language-bash "repositories": [ { "type": "composer", "url": "https://repo.magento.com/" } ]
-
Haal de Composer-naam en -versie van de extensie op.
-
Werk het
composer.json
dossier in uw project met de naam en de versie van de uitbreiding bij. -
Controleer of de extensie correct is geïnstalleerd.
-
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:
-
Login aan Commerce Marketplacemet de gebruikersbenaming en het wachtwoord u gebruikte om de uitbreiding te kopen.
-
In de hoger-juiste hoek, klik Uw naam > Mijn Profiel.
-
Klik Mijn Aankopen.
-
Vind de uitbreiding die u wilt installeren en Technische Details klikken.
composer.json
kocht.Composerafhankelijkheden bijwerken
Voeg de naam en de versie van de extensie toe aan het composer.json
-bestand:
-
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
-
Ga uw authentificatietoetsenin. Uw openbare sleutel is uw gebruikersnaam; uw persoonlijke sleutel is uw wachtwoord.
-
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.
-
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.
-
De extensie registreren:
code language-bash bin/magento setup:upgrade
-
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
-
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
-
De cache reinigen:
code language-bash bin/magento cache:clean
-
Configureer de extensie naar wens in Admin.
bin/magento cache:flush
.Upgrade
Een module of extensie bijwerken of bijwerken:
-
Download het bijgewerkte bestand van Marketplace of een andere ontwikkelaar van extensies. Noteer de naam en de versie van de module.
-
Exporteer de inhoud naar de hoofdmap van de toepassing.
-
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
-
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
De volgende instructies bevatten algemene informatie voor het verwijderen van extensies van derden:
-
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 <package-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>/<module-name>
-
-
Als het
config.php
-bestand zich onder bronbeheer in uw Adobe Commerce-projectopslagplaats bevindt, verwijdert u de extensie uit hetconfig.php
-bestand. -
Test uw lokale gegevensbestand om ervoor te zorgen dat de verkoper-geleverde instructies zoals verwacht werken.
-
Controleer of de extensie correct is uitgeschakeld en of uw website naar behoren werkt in uw testomgeving.
-
Implementeer de wijzigingen in uw productieomgeving.