Difference between revisions of "Installing Magento Extensions : Easy Install Guide"

From Moogento How-to Guides
Jump to navigation Jump to search
m
m
 
(68 intermediate revisions by the same user not shown)
Line 1: Line 1:
−
Make sure you've gone through the [[Pre-install_Checklist]] before starting!
+
{{#seo:
−
==Copying the files==
+
|title=Installing Magento 1 Extensions : Easy Install Guide
 +
|title_mode=replace
 +
}}
 +
{{#description2:Easy guide to installing Magento extensions. We'll make it so easy you can knock this out in a few minutes.}}
 +
==Aims & Preparation==
 +
Make sure you've gone through the [[Installing_Magento_Extensions_:_Pre-install_Checklist|Pre-install Checklist]] before starting!
  
 +
{{idea|Upgrading from an older version? Check our [https://www.moogento.com/guides/Installing_Magento_Extensions_:_Pre-install_Checklist#Updating_Previous_Versions_of_Moogento_Extensions Upgrading Extensions Guide]}}
 +
 +
 +
 +
 +
 +
 +
 +
==Installation==
 +
===1. Upload The Files===
 
# Unzip your extension package.
 
# Unzip your extension package.
 
# Inside that package you'll see {{folder|Step_1}}, open that folder inside your FTP app.
 
# Inside that package you'll see {{folder|Step_1}}, open that folder inside your FTP app.
 
# Locate your website's Magento {{folder|app}} folder in the same app. You should now have the contents of {{folder|Step_1}} on one side, and your main website folder (containing the Magento app folder) on the other side. Check that you see an {{folder|app}} folder each side.[[File:ftp_install_magento_extensions.png|link=|674px]]
 
# Locate your website's Magento {{folder|app}} folder in the same app. You should now have the contents of {{folder|Step_1}} on one side, and your main website folder (containing the Magento app folder) on the other side. Check that you see an {{folder|app}} folder each side.[[File:ftp_install_magento_extensions.png|link=|674px]]
 
# Drag the folders from inside {{folder|Step_1}} into your remote site (the important thing here is not to drag on top of another folder, or the files will be placed in the wrong location - easiest is to drag onto a file or blank space on the remote side).[[File:magento_install_drag_n_drop.png|link=|674px]]
 
# Drag the folders from inside {{folder|Step_1}} into your remote site (the important thing here is not to drag on top of another folder, or the files will be placed in the wrong location - easiest is to drag onto a file or blank space on the remote side).[[File:magento_install_drag_n_drop.png|link=|674px]]
−
# You may be asked {{keypress|Merge or Replace?}} by your FTP app. Choose {{keypress|Merge}} for folders and {{keypress|Replace}} for files.
+
# You may be asked {{keypress|Merge or Replace?}} by your FTP app. Choose {{keypress|Merge}} for folders and {{keypress|Replace}} for files.[[File:merge_folders_replace_files.png|link=|674px]]
 
# When that has completed, open {{folder|Step_2}} in your unzipped extension folder.
 
# When that has completed, open {{folder|Step_2}} in your unzipped extension folder.
 
# Using the same procedure, copy the contents of {{folder|Step_2}} into the same location in your Magento installation.[[File:ftp_install_magento_extensions_step2.png|link=|674px]]
 
# Using the same procedure, copy the contents of {{folder|Step_2}} into the same location in your Magento installation.[[File:ftp_install_magento_extensions_step2.png|link=|674px]]
 +
# ''If you're using a 3rd party admin theme, you '''may''' need to also copy the contents of {{folder|skin/adminhtml/default/default}} folder into '''both''' {{folder|skin/adminhtml/default/[skin name]}} '''and''' {{folder|skin/adminhtml/go}}''
 +
# If you're installing '''pickPack''' ''and are going to be attaching fonts to your PDFs'' (eg. custom fonts or non-Roman characters), then, also using the same procedure, copy the contents of {{folder|Step_Optional_Font_Pack}} into the same location in your Magento installation.
  
−
==Clear the cache==
+
===2. Clear the Cache and Assign User Permissions===
−
# Go to the {{menuchoice|System > Cache}} settings, and clear all caches (click {{keypress_orange|Flush Magento Cache}} and {{keypress_orange|Flush Cache Storage}}).
+
# Go to the {{menu|System|Cache}} settings, and clear all caches (click {{keypress_orange|Flush Magento Cache|}} and {{keypress_orange|Flush Cache Storage|}}).
 +
#:'''Do this even if you have caching generally disabled.'''
 
# Log out then Log in.
 
# Log out then Log in.
−
# Head to {{menuchoice|System > Permissions > Roles}}.
+
#: ''This will allow you to edit the config page for this extension (and avoid the 404 error).''
 +
# Head to {{menu3|System|Permissions|Roles}}
 
# Check that you have assigned the new Moogento Extension options to the appropriate roles, and save.
 
# Check that you have assigned the new Moogento Extension options to the appropriate roles, and save.
−
# Head to {{menuchoice|System > Permissions > Users}}.
+
#:*If saving an admin role, likely you have 'All' resources set; just re-save this:
−
# Check that you have assigned the new Moogento Extension options to the appropriate users, and save.
+
#:[[File:magento-full-user-access-role.png|link=|280px]]
−
# Navigate to {{menuchoice|System > Configuration}} and then to the specific config page for your new Moogento Extension.
+
#:*If saving a partial access role (eg. granting pickers access to create Packing Sheets), find the new extension sections and grant as needed (eg. here is access to mass-action menu options):
 +
#:[[File:action-menu-role.png|link=|363px]]
 +
#:*Don't forget to set the access to the '''System>Configuration''' section if you need to:
 +
#:[[File:system-config-role.png|link=|363px]]
 +
# Head to {{menu3|System|Permissions|Users}}
 +
# Check that you have assigned the correct role (that we just granted the appropriate Extension options to) to the appropriate users, and save.
 +
#:[[File:user-access-choice.png|link=|525px]]
 +
 
 +
 
 +
===3. Enter the License Key===
 +
If you're installing a Moogento extension, we'll have sent you a license key. Let's install it!
 +
 
 +
# Navigate to {{menu|System|Configuration}} and then to the specific config page for your new Extension.
 
# At the top, if this extension requires a license key, enter your license key (this will have been emailed to you; you can also find it inside your Moogento account downloads section).
 
# At the top, if this extension requires a license key, enter your license key (this will have been emailed to you; you can also find it inside your Moogento account downloads section).
−
# Save this page.
+
#* Click the 'License' word to expand that section if it's not already showing the key entry field.
−
# Check that it works at a basic level; this is also a good time to check your public store front. I would also make a test order at this stage.
+
#* Enter the key and save the page:
 +
#:[[File:entering-magento-license-key.png|link=|900px]]
 +
 
 +
 
 +
===4. Save the Config Page===
 +
After entering the license key, save the config page.
 +
*Even if you're installing an extension without a license key, it's still a good idea to '''save the config section at this point''' (even if you've not made any changes).
 +
:''(It's possible to generate some errors if running some extensions without values saved to the config).''
 +
*Clear the Magento cache, and then the browser cache.
 +
''If you're not sure about browser cache, what usually works is holding the shift button and clicking refresh.''
 +
 
 +
 
 +
 
 +
 
 +
 
 +
==Registering the License==
 +
===Setup the Key for Dev/Staging Sites===
 +
If you're setting up on a dev or staging server, we've got you covered. You can assign up to 2 dev/staging servers to each key, and we have a super-simple way to assign them.
 +
# Navigate to your Moogento Account downloads section.
 +
# Find the specific extension you want to request dev/staging access for.
 +
# Click '+ dev domain'
 +
# Enter the domain name.
 +
# Click 'Request'
 +
# Done! We'll check that and assign it within 1 working day.
 +
#:[[File:dev-licenses.png|link=|674px]]
 +
* If your dev site is not an obvious dev subdomain (dev. / stage. / etc.) please ensure that the site is [[Installing_Magento_Extensions_:_Troubleshooting#.22I_need_to_set_the_Magento_demo_site_notice..22|showing the Magento 'demo site' message]].
 +
 
 +
* Enter the license key in every install you make with our software, including dev & staging sites.
 +
 
 +
* Before installing the software, please add the domain you'll be using to the list of authorised domains, as described above.
 +
 
 +
:''It's against the terms of your license to use the software: ''
 +
 
 +
::''- without entering the license key in every install''
 +
 
 +
::''- without authorising the domain before use''
 +
:::'' (only needed if you're using multiple domains for testing - the first-used domain is registered automatically)''
 +
 
 +
::''- on multiple Magento installations''
 +
:::''(excepted : dev/staging sites for the specific domain the key is purchased for)''
 +
 
 +
 
 +
 
 +
==Final Check==
 +
# Check that it works at a basic level; this is also a good time to check your public store front. I would also make a test order at this stage, check that the emails you're expecting are coming through etc.
 
# If everything is ok and you have previously disabled compilation, now you can enable it.
 
# If everything is ok and you have previously disabled compilation, now you can enable it.
  
 
You should now be setup at a basic level.
 
You should now be setup at a basic level.
  
−
If you have any issues, check the [[Troubleshooting_Installation|Troubleshooting]] guide.
+
If you have any issues, check the [[Installing_Magento_Extensions_:_Troubleshooting|Troubleshooting]] guide.
 +
 
  
 
[[Category:Extension installation]]
 
[[Category:Extension installation]]

Latest revision as of 14:16, 29 September 2020


Aims & Preparation

Make sure you've gone through the Pre-install Checklist before starting!

Upgrading from an older version? Check our Upgrading Extensions Guide




Installation

1. Upload The Files

  1. Unzip your extension package.
  2. Inside that package you'll see Step_1, open that folder inside your FTP app.
  3. Locate your website's Magento app folder in the same app. You should now have the contents of Step_1 on one side, and your main website folder (containing the Magento app folder) on the other side. Check that you see an app folder each side.ftp install magento extensions.png
  4. Drag the folders from inside Step_1 into your remote site (the important thing here is not to drag on top of another folder, or the files will be placed in the wrong location - easiest is to drag onto a file or blank space on the remote side).magento install drag n drop.png
  5. You may be asked Merge or Replace? by your FTP app. Choose Merge for folders and Replace for files.merge folders replace files.png
  6. When that has completed, open Step_2 in your unzipped extension folder.
  7. Using the same procedure, copy the contents of Step_2 into the same location in your Magento installation.ftp install magento extensions step2.png
  8. If you're using a 3rd party admin theme, you may need to also copy the contents of skin/adminhtml/default/default folder into both skin/adminhtml/default/[skin name] and skin/adminhtml/go
  9. If you're installing pickPack and are going to be attaching fonts to your PDFs (eg. custom fonts or non-Roman characters), then, also using the same procedure, copy the contents of Step_Optional_Font_Pack into the same location in your Magento installation.

2. Clear the Cache and Assign User Permissions

  1. Go to the SystemCache settings, and clear all caches (click Flush Magento Cache and Flush Cache Storage).
    Do this even if you have caching generally disabled.
  2. Log out then Log in.
    This will allow you to edit the config page for this extension (and avoid the 404 error).
  3. Head to SystemPermissionsRoles
  4. Check that you have assigned the new Moogento Extension options to the appropriate roles, and save.
    • If saving an admin role, likely you have 'All' resources set; just re-save this:
    magento-full-user-access-role.png
    • If saving a partial access role (eg. granting pickers access to create Packing Sheets), find the new extension sections and grant as needed (eg. here is access to mass-action menu options):
    action-menu-role.png
    • Don't forget to set the access to the System>Configuration section if you need to:
    system-config-role.png
  5. Head to SystemPermissionsUsers
  6. Check that you have assigned the correct role (that we just granted the appropriate Extension options to) to the appropriate users, and save.
    user-access-choice.png


3. Enter the License Key

If you're installing a Moogento extension, we'll have sent you a license key. Let's install it!

  1. Navigate to SystemConfiguration and then to the specific config page for your new Extension.
  2. At the top, if this extension requires a license key, enter your license key (this will have been emailed to you; you can also find it inside your Moogento account downloads section).
    • Click the 'License' word to expand that section if it's not already showing the key entry field.
    • Enter the key and save the page:
    entering-magento-license-key.png


4. Save the Config Page

After entering the license key, save the config page.

  • Even if you're installing an extension without a license key, it's still a good idea to save the config section at this point (even if you've not made any changes).
(It's possible to generate some errors if running some extensions without values saved to the config).
  • Clear the Magento cache, and then the browser cache.

If you're not sure about browser cache, what usually works is holding the shift button and clicking refresh.



Registering the License

Setup the Key for Dev/Staging Sites

If you're setting up on a dev or staging server, we've got you covered. You can assign up to 2 dev/staging servers to each key, and we have a super-simple way to assign them.

  1. Navigate to your Moogento Account downloads section.
  2. Find the specific extension you want to request dev/staging access for.
  3. Click '+ dev domain'
  4. Enter the domain name.
  5. Click 'Request'
  6. Done! We'll check that and assign it within 1 working day.
    dev-licenses.png
  • Enter the license key in every install you make with our software, including dev & staging sites.
  • Before installing the software, please add the domain you'll be using to the list of authorised domains, as described above.
It's against the terms of your license to use the software:
- without entering the license key in every install
- without authorising the domain before use
(only needed if you're using multiple domains for testing - the first-used domain is registered automatically)
- on multiple Magento installations
(excepted : dev/staging sites for the specific domain the key is purchased for)


Final Check

  1. Check that it works at a basic level; this is also a good time to check your public store front. I would also make a test order at this stage, check that the emails you're expecting are coming through etc.
  2. If everything is ok and you have previously disabled compilation, now you can enable it.

You should now be setup at a basic level.

If you have any issues, check the Troubleshooting guide.

Retrieved from "https://moogento.com/guides/index.php?title=Installing_Magento_Extensions_:_Easy_Install_Guide&oldid=2637"