Difference between revisions of "Installing Magento 2 Extensions : Troubleshooting"
m |
|||
(68 intermediate revisions by 2 users not shown) | |||
Line 1: | Line 1: | ||
+ | {{#seo: | ||
+ | |title=Installing Magento 2 Extensions : Troubleshooting your Setup | ||
+ | |title_mode=replace | ||
+ | }} | ||
+ | {{#description2:Troubleshooting installation of Magento 2 extensions. Having issues getting your Magento plugins running? We've got some quick tips to get you on your way.}} | ||
__TOC__ | __TOC__ | ||
==Magento Help== | ==Magento Help== | ||
Line 24: | Line 29: | ||
:: <code>php bin/magento setup:di:compile</code> | :: <code>php bin/magento setup:di:compile</code> | ||
− | |||
− | |||
:: <code>php bin/magento setup:static-content:deploy -f</code> | :: <code>php bin/magento setup:static-content:deploy -f</code> | ||
Line 34: | Line 37: | ||
==="After install I get a '500 Internal Server Error' in the browser"=== | ==="After install I get a '500 Internal Server Error' in the browser"=== | ||
− | # Check your server error logs first | + | # Check your server error logs first: |
#: Where this is will depend on your server. Here's some common examples: | #: Where this is will depend on your server. Here's some common examples: | ||
#: Centos: {{folder|{server root}/var/log/httpd/}} | #: Centos: {{folder|{server root}/var/log/httpd/}} | ||
Line 41: | Line 44: | ||
#: MageMojo: {{folder|/home/log/apache/error.log}} | #: MageMojo: {{folder|/home/log/apache/error.log}} | ||
#: Access eg. via <code>nano /var/log/httpd/apache_error.log</code> | #: Access eg. via <code>nano /var/log/httpd/apache_error.log</code> | ||
− | # If the error isn't apparent in those logs, you might | + | # If the error isn't apparent in those logs, you might have some old static content that needs a tickle: |
#: | #: | ||
## Move {{folder|pub/static/.htaccess}} somewhere out of that folder | ## Move {{folder|pub/static/.htaccess}} somewhere out of that folder | ||
Line 49: | Line 52: | ||
#: | #: | ||
#:Or in one line: | #:Or in one line: | ||
+ | #: | ||
+ | #: <code>php bin/magento maintenance:enable</code> | ||
#: | #: | ||
#:<code>mv pub/static/.htaccess pub/.htaccess</code> | #:<code>mv pub/static/.htaccess pub/.htaccess</code> | ||
Line 57: | Line 62: | ||
#: | #: | ||
#:<code>mv pub/.htaccess pub/static/.htaccess</code> | #:<code>mv pub/.htaccess pub/static/.htaccess</code> | ||
+ | #: | ||
+ | #: <code>php bin/magento maintenance:disable</code> | ||
#: | #: | ||
# If that didn't help, you might have some old composer files causing issues. | # If that didn't help, you might have some old composer files causing issues. | ||
Line 62: | Line 69: | ||
## Delete {{folder|/vendor}} : <code>rm -R vendor</code> | ## Delete {{folder|/vendor}} : <code>rm -R vendor</code> | ||
## Run <code>composer update</code> | ## Run <code>composer update</code> | ||
+ | |||
==="After install I get a fatal error, with 'Unable to retrieve deployment version of static files from the file system' in the reports"=== | ==="After install I get a fatal error, with 'Unable to retrieve deployment version of static files from the file system' in the reports"=== | ||
Line 115: | Line 123: | ||
<code>php bin/magento setup:static-content:deploy -f</code> | <code>php bin/magento setup:static-content:deploy -f</code> | ||
− | ==[ | + | ==="I get this error: 'The following modules are outdated'"=== |
+ | It might also say '''Moogento_{module} db schema version: defined in codebase - {v1), currently installed - {not v1)'''. | ||
+ | # Load up your Magento database, eg. in phpMyAdmin | ||
+ | # Find the {possible_prefix_}setup_module table | ||
+ | # Find the entry relating to the module mentioned, eg. 'Moogento_Pickpack' | ||
+ | # Delete that entry | ||
+ | # Run <code>bin/magento setup:upgrade</code> to recreate the correct line | ||
+ | |||
+ | ==="When I activate a plugin, I get a 'circular dependency' error in admin"=== | ||
+ | If you see this, your install hasn't completed correctly. | ||
+ | |||
+ | Try this: | ||
+ | |||
+ | # Check you've registered all your dev & live domains in your Moogento account for the correct key. | ||
+ | # Backup your site files & database | ||
+ | # Enable Maintenance Mode. | ||
+ | # Re-copy all plugin files from the latest version. | ||
+ | # Check there's not multiple admin users logged in. | ||
+ | # Reset the install tag, according to [https://moogento.com/guides/Installing_Magento_2_Extensions_:_Troubleshooting#.22I_get_this_error:_.27The_following_modules_are_outdated.27.22 this method]. | ||
+ | # Remove generated files (see [https://devdocs.magento.com/guides/v2.3/howdoi/php/php_clear-dirs.html here] for details): | ||
+ | #: <code>rm -rf generated/metadata/* generated/code/* vendor/* var/cache/* var/generation/* var/view_preprocessed/* var/page_cache/* pub/static/frontend/* pub/static/adminhtml/* -R</code> | ||
+ | # Update composer (re-generate the /vendor folder): | ||
+ | #: <code>composer update</code> | ||
+ | #: <code>php bin/magento setup:upgrade</code> | ||
+ | # Compile (re-generate files): | ||
+ | #: <code>php bin/magento setup:di:compile</code> | ||
+ | # Set file & folder permissions: | ||
+ | #: <code>find . -type f -exec chmod 644 {} \;</code> | ||
+ | #: <code>find . -type d -exec chmod 755 {} \;</code> | ||
+ | # Check the file ownership. You should have a specific server user (not root) that runs magento. | ||
+ | #: eg. if that user is 'magento_user: | ||
+ | #: <code>chown -R magento_user:magento_user *</code> | ||
+ | # Update Magento db: | ||
+ | #: <code>php bin/magento setup:db-schema:upgrade</code> | ||
+ | # Reindex & clear caches: | ||
+ | #: <code>php bin/magento indexer:reindex</code> | ||
+ | #: <code>php bin/magento cache:clean && php bin/magento cache:flush && php bin/magento cache:enable</code> | ||
+ | # Disable maintenance mode: | ||
+ | #: <code>php bin/magento maintenance:disable</code> | ||
+ | |||
+ | ==="Running compile hangs with no errors"=== | ||
+ | Part of running Magento 2 stores is running compile (including when installing plugins): | ||
+ | : <code>bin/magento setup:di:compile -vvv</code> | ||
+ | |||
+ | but, sometimes this hangs with no indication what's up. | ||
+ | |||
+ | There's a couple things we can do. | ||
+ | |||
+ | * Try with '-vvv' to show more info | ||
+ | : <code>bin/magento setup:di:compile -vvv</code> | ||
+ | |||
+ | * In {{folder|app/bootstrap.php}} around line 11, enable <code>ini_set('display_errors', 1);</code> | ||
+ | then re-run compile. | ||
+ | |||
+ | ==="I get an error like 'Base table or view not found: ''(eg. moogentoshipeasycolumn)'' doesn't exist'"=== | ||
+ | |||
+ | This generally means there's a mismatch in tables in the database. | ||
+ | |||
+ | The cause is usually an incomplete install, if you skipped updates over a long time period, and sometimes from trying to use an extension without registering the license key. | ||
+ | |||
+ | The solution is to restart the module install in Magento, by removing the entry from the 'setup_module' table in your db. | ||
+ | |||
+ | eg. for M2 stockEasy the line is 'Moogento_Stockeasy'. Just remove that line and re-run the M2 database setup command. | ||
+ | |||
+ | # Delete the relevant line from ''setup_module'', eg: | ||
+ | #:[[File:restart-magento-plugin-install.png|link=|400px]] | ||
+ | # Run the db update command: | ||
+ | #: <code>php bin/magento setup:upgrade</code> | ||
+ | |||
+ | {{idea|Removing db entries for the plugins will remove settings related to that plugin}} | ||
+ | : * ''If you have specific settings saved to the plugin that you want to keep, export the relevant tables/entries first'' | ||
+ | : * ''After re-install you can then import/replace the relevant entries'' | ||
+ | |||
+ | '''Suggestions''' | ||
+ | |||
+ | ''These are not required, but to keep the db trim, it can be a good idea.'' | ||
+ | |||
+ | * If you're restarting the install, removing tables related to the same plugin at the same time can be a good way to get a fresh setup. | ||
+ | : * ''Recent Moogento plugins will usually name the tables like {moogento}_{plugin}_{specific} eg. moogento_stockeasy_columns'' | ||
+ | : * eg. SQL: <code>SHOW TABLES LIKE "%moo%"</code> | ||
+ | :: ''^ Don't delete all entries unless you're re-installing *all* moogento modules!'' | ||
+ | * Also remove entries from core_config_data | ||
+ | : * ''Recent Moogento plugins will usually name the entries like {moogento or moo}_{plugin}/{specific} eg. moogento_stockeasy/grid_colors'' | ||
+ | : * eg. SQL: <code>SELECT * FROM `mg_core_config_data` WHERE `path` LIKE '%moo%' ORDER BY `path` DESC</code> | ||
+ | :: ''^ Don't delete all entries unless you're re-installing *all* moogento modules!'' | ||
+ | |||
+ | ==="I see empty tables in the plugin config page"=== | ||
+ | |||
+ | If you've been updating the module, something might have gone sideways - try restarting the install. | ||
+ | |||
+ | Just log in to your database (eg. using phpMyAdmin) and find the setup_module table. Search for the line related to the plugin (eg. <code>LIKE %stockeasy%</code>) and delete it, then run the M2 database upgrade: | ||
+ | |||
+ | <code>php bin/magento setup:upgrade</code> | ||
+ | |||
+ | ==="I get this error: 'Exception Printing is Disabled by Default for Security Reasons'"=== | ||
+ | This means that you're set to hide errors; this is recommended for production sites, but for developing a site it's helpful to see errors. | ||
+ | |||
+ | In {{folder|app/bootstrap/index.php}} and {{folder|/index.php}} set this (uncommented) at the top of the file: | ||
+ | |||
+ | <code>ini_set('display_errors', 1);</code> | ||
+ | |||
+ | ==="The Moogento license & config sections go blank & I get this error: '(Zend_Http_Exception): Invalid header line detected : Zend_Http_Response::extractHeaders'"=== | ||
+ | |||
+ | This is a bug in older Magento versions which had issues with http2 responses. Here's the fix (once you're updated to M2.3.3+ you can remove the fix): | ||
+ | |||
+ | |||
+ | 1. In {{folder|/composer.json}}, add: | ||
+ | |||
+ | <code> | ||
+ | composer.json "autoload": { | ||
+ | ... | ||
+ | "files": [ | ||
+ | ... | ||
+ | "lib/Zend/Http/Response.php" | ||
+ | ] | ||
+ | } | ||
+ | </code> | ||
+ | |||
+ | It'll then look something like this: | ||
+ | |||
+ | [[File:magento-composer.png|link=|400px]] | ||
+ | |||
+ | |||
+ | 2. Copy | ||
+ | |||
+ | {{folder|vendor/magento/zendframework1/library/Zend/Http/Response.php}} | ||
+ | |||
+ | to | ||
+ | |||
+ | {{folder|lib/Zend/Http/Response.php}} | ||
+ | |||
+ | |||
+ | 3. In that file, edit these lines: | ||
+ | |||
+ | [Line 185] | ||
+ | |||
+ | <code>if (! preg_match('#^\d|\d(\.\d)*$#', $version)) {</code> | ||
+ | |||
+ | [line 517] | ||
+ | |||
+ | <code>if ($index === 0 && preg_match('#^HTTP/\d(?:\.\d+)* [1-5]\d+#', $line)) {</code> | ||
+ | |||
+ | |||
+ | 4. Run <code>composer dump-autoload</code> | ||
+ | |||
+ | |||
+ | ==="When loading the Orders or Catalog page, I see a 'server error', or 'Attention: Something went wrong', but only with a specific user"=== | ||
+ | |||
+ | #:[[File:magento-grid-load-error.png|link=|200px]] | ||
+ | |||
+ | First try logging in as a different user. This error is usually a result of some corruption in the table that records user-specific grid settings (filters, columns etc.), so changing user can get you out of a fix in the short term. | ||
+ | |||
+ | For a deeper solution, try clearing the '''ui_bookmark''' table. | ||
+ | |||
+ | To do this, you need to: | ||
+ | |||
+ | # Access your database (eg. in cPanel you can click 'phpMyAdmin', then the database you're using for Magento 2) | ||
+ | # Browse that '''ui_bookmark''' table; this is where user-specific filters, column setup, column sorts, are stored | ||
+ | # You'll see user_id as a column - you can either find the specific user id you need to clear, or just clear the lot | ||
+ | # To clear, select all the lines, then click 'Delete' | ||
+ | |||
+ | After this follow the instructions below on clearing your browser cache. | ||
+ | |||
+ | If you still have issues after this then you'll want to dig in and find the core issue. | ||
+ | |||
+ | ==="When loading the Orders or Catalog page, after an upgrade, some interactive parts don't work"=== | ||
+ | You've likely got some old javascript files cached locally - check that you've cleared your browser cache. | ||
+ | |||
+ | The easiest way to do this is: | ||
+ | |||
+ | # (In Chrome, similar in Edge, Firefox, Safari) right-click in the page > 'Inspect'. | ||
+ | # Then right-click the url refresh button, and 'Empty Cache & Hard Reload'. | ||
+ | |||
+ | |||
+ | ==[https://moogento.com/pickpack-m2 PickPack (M2)]:== | ||
==="After install I get a 'Unknown module(s): 'Moogento_PickPack' error"=== | ==="After install I get a 'Unknown module(s): 'Moogento_PickPack' error"=== | ||
Line 138: | Line 320: | ||
and then setting the ''Admin Session'' timeout to ''86400'' in the admin config.. | and then setting the ''Admin Session'' timeout to ''86400'' in the admin config.. | ||
+ | |||
+ | |||
+ | ==="After install I see missing images or strange formatting in the PDF editor"=== | ||
+ | Clear static files as [https://moogento.com/guides/Installing_Magento_2_Extensions_:_Troubleshooting#.22After_install_I_get_a_.27500_Internal_Server_Error.27_in_the_browser.22 above]. | ||
Line 219: | Line 405: | ||
− | ==[ | + | ==="The printed date doesn't match the date showing in the Orders page"=== |
+ | |||
+ | pickPack allows you to choose which date you want to print: | ||
+ | |||
+ | * Printed date | ||
+ | * Ordered date | ||
+ | * Invoiced date | ||
+ | * Credited date | ||
+ | * Shipment date | ||
+ | |||
+ | Just: | ||
+ | # Edit the page you're after | ||
+ | # Click the 'Free text' block that you want to add a date to | ||
+ | # Place the cursor in the text field for that block, where you want to add the date | ||
+ | # Click the type of date you want to add | ||
+ | # Save | ||
+ | |||
+ | :::[[File:setting-pdf-date-magento2.png|link=|400px]] | ||
+ | |||
+ | * Note you can set the way the date is formatted (eg. '1/2/19', '1st Feb 2019', etc) in the pickPack General config. | ||
+ | |||
+ | |||
+ | ==="I'm using Magento 2.2.7 and having email-related errors"=== | ||
+ | ==="I get this error: 'Class Zend\Mime\PartFactory does not exist in [Moogento\PickPack\Mail\Template\TransportBuilder\Interceptor]'"=== | ||
+ | If you're running a version of Magento less than 2.2.8, there's a quick command you need to run. | ||
+ | |||
+ | # Run this command in your main Magento install folder: | ||
+ | #:<code>composer require zendframework/zend-mime</code> | ||
+ | # Follow with the usual Magento update commands. | ||
+ | |||
+ | ==="I get this error: 'Warning: file_put_contents(/var/tmp/moogento/pickpack/pdf.html): failed to open stream: No such file or directory'"=== | ||
+ | You've got some permission or ownership issue with your setup (pickPack can't write its temp files while creating the PDFs). | ||
+ | |||
+ | It's time to [https://moogento.com/guides/Magento_2_Quick_Setup_Check#Check_file.2Ffolder_ownership.2Fpermissions check Magento 2 file ownership & permissions]. | ||
+ | |||
+ | ==="I get this error: 'Fatal error: Interface 'Magento\Framework\Filter\SimpleDirective\ProcessorInterface' not found'"=== | ||
+ | Please upgrade to Magento 2.3.4+ | ||
+ | |||
+ | ''If you need to run <2.3.4 feel free to get in touch and we can get it working for you.'' | ||
+ | |||
+ | ==="I get this error: 'libpng warning: iCCP: known incorrect sRGB profile'"=== | ||
+ | ==="I get this error: 'libpng warning: Interlace handling should be turned on when using png_read_image'"=== | ||
+ | These are core issues in PHP that are still present in PHP8: | ||
+ | |||
+ | |||
+ | https://github.com/libgd/libgd/issues/295 | ||
+ | |||
+ | https://bugs.php.net/bug.php?id=71316 | ||
+ | |||
+ | |||
+ | The cause is your catalog having some images saved as png format (we recommend jpeg), and then having those images also saved (eg via Photoshop) with a color profile attached, or saved as interlaced format. | ||
+ | |||
+ | |||
+ | You're likely to encounter other issues elsewhere with these images so our recommendation is to re-process them: | ||
+ | |||
+ | |||
+ | - ideally as jpegs | ||
+ | |||
+ | |||
+ | - or, re-process them with no color profile and not interlaced pngs | ||
+ | |||
+ | |||
+ | ==[https://moogento.com/shipeasy-m2 ShipEasy (M2)]:== | ||
==="When installing, after running compile on production, I get an error 'The directory /var/generation cannot be deleted'"=== | ==="When installing, after running compile on production, I get an error 'The directory /var/generation cannot be deleted'"=== | ||
Line 230: | Line 478: | ||
:<code>php bin/magento setup:static-content:deploy en_US fr_FR</code> | :<code>php bin/magento setup:static-content:deploy en_US fr_FR</code> | ||
+ | |||
==="After install I see a spinning wheel in the Orders page which doesn't go away"=== | ==="After install I see a spinning wheel in the Orders page which doesn't go away"=== | ||
Your install may not have completed correctly. | Your install may not have completed correctly. | ||
+ | |||
+ | ==="When triggering emails (eg. via Ship & Invoice), we have issues."=== | ||
+ | |||
+ | If you're running 2.3.4+, it's stricter when processing templates - check that you don't have incomplete IF clauses in templates. | ||
# Try re-running the [https://moogento.com/guides/Installing_Magento_2_Extensions_:_Easy_Install_Guide#4._Run_Install_.26_Setup_Scripts installation compile commands]. | # Try re-running the [https://moogento.com/guides/Installing_Magento_2_Extensions_:_Easy_Install_Guide#4._Run_Install_.26_Setup_Scripts installation compile commands]. | ||
Line 258: | Line 511: | ||
::: Then clear the caches: | ::: Then clear the caches: | ||
::: <code>php bin/magento cache:clean && php bin/magento cache:flush && php bin/magento cache:enable</code> | ::: <code>php bin/magento cache:clean && php bin/magento cache:flush && php bin/magento cache:enable</code> | ||
+ | |||
+ | |||
+ | ==="When editing a shipping address from the orders page (by clicking the pencil icon) I get an error."=== | ||
+ | If you've recently updated, please check you've still got the custom address parts selected in the shipEasy config. | ||
+ | |||
+ | |||
+ | ==="The Orders page doesn't work correctly with the Amasty 'Extended Order Grid' module installed"=== | ||
+ | Aka Amasty_Ogrid. | ||
+ | |||
+ | Download and install this patch: | ||
+ | |||
+ | [https://moogento.com/downloads/ShipeasyAmastyOgridCompatible.zip https://moogento.com/downloads/ShipeasyAmastyOgridCompatible.zip] | ||
+ | |||
+ | The grid should now load correctly. | ||
+ | |||
+ | |||
+ | ==="After updating I get an error: 'Column with key moo_shipeasy_ordertag_1 does not exist'"=== | ||
+ | In ShipEasy Config -> [Orders Page: Columns] find the entry for 'OrderTag: 1'. If the Options box is empty, add some options, eg: | ||
+ | |||
+ | <code>Alert Flag|flag_alert.svg,</code> | ||
+ | |||
+ | <code>Tick|flag_tick.svg,</code> | ||
+ | |||
+ | <code>Cross|flag_cross.svg</code> | ||
+ | |||
+ | Likewise check 'OrderTag: Printed' - if that options box is empty add the default options: | ||
+ | |||
+ | <code>Printed|printed|#f0dba6,</code> | ||
+ | |||
+ | <code>Auto|auto|#f0dba6,</code> | ||
+ | |||
+ | <code>New|new|#e5f3d4</code> | ||
+ | |||
+ | |||
+ | ==="After installing ShipEasy some column options are missing and/or the ShipEasy config customise columns table is truncated"=== | ||
+ | This sometimes happens if the site wasn't put in maintenance for install, or there were some missing files or some other issues that affected the smooth install. | ||
+ | |||
+ | Execute this SQL and then run the setup:upgrade commands: | ||
+ | |||
+ | <code>DELETE FROM `patch_list` WHERE (`patch_name` LIKE '%Moogento\\\\Shipeasy\\\\Setup\\\\Patch\\\\Data\\\\PopulateDefaultColumns%');</code> | ||
+ | |||
+ | This would normally trigger re-adding default columns to the ShipEasy custom column table. | ||
+ | |||
+ | |||
+ | ==[https://moogento.com/stockeasy-m2 StockEasy (M2)]:== | ||
+ | |||
+ | ==="When installing and running update, I get an error 'Uncaught Error: Cannot instantiate interface'"=== | ||
+ | |||
+ | Try this: | ||
+ | <code>rm -rf var/page_cache var/cache var/composer_home var/generation generated/code generated/metadata var/di var/view_preprocessed/*</code> | ||
+ | <code>redis-cli FLUSHALL</code> | ||
+ | |||
+ | If you're running redis but that command doesn't show a result, then you should check with your host the correct command to use. | ||
+ | |||
+ | |||
+ | ==[https://moogento.com/picknscan-m2 Pick-n-Scan (M2)]:== | ||
+ | |||
+ | ==="I want to always launch the app in fullscreen"=== | ||
+ | Pick-n-Scan has an option in Config to show a 'fullscreen' button, which then shows up in the 'hamburger' menu. | ||
+ | |||
+ | Once clicked, the app will go fullscreen and you'll have more vertical space. | ||
+ | |||
+ | If you'd like to launch this fullscreen - this can make sense for warehouse scanning devices - then you just need to 'save to homescreen' the relevant url. | ||
+ | |||
+ | |||
+ | Here's the steps to add the homescreen shortcut on Chrome (other browsers will be similar) on Android (iOS is also similar): | ||
+ | |||
+ | 1. Launch "Chrome" app. | ||
+ | |||
+ | 2. Open the URL you want to pin to your home screen (ie. navigate to the scan screen from the Orders page) | ||
+ | |||
+ | 3. Tap the menu icon (3 dots in upper right-hand corner) and tap 'Add to homescreen'. | ||
+ | |||
+ | 4. You'll be able to enter a name for the shortcut (eg. "Pick-n-Scan") and then Chrome will add it to your home screen. | ||
+ | |||
+ | 5. Now when launching the url via clicking that new icon, it should launch fullscreen (with no address bar). | ||
=="I still have issues"== | =="I still have issues"== | ||
Line 278: | Line 607: | ||
'''Via CLI''' | '''Via CLI''' | ||
− | : <code>php bin/magento config:set | + | : <code>php bin/magento config:set --enable-debug-logging=true && php bin/magento cache:flush</code> |
: ''If you get a --lock error then try this:'' | : ''If you get a --lock error then try this:'' | ||
− | :: <code>php bin/magento config:set --lock | + | :: <code>php bin/magento config:set --lock --enable-debug-logging=true 1 && php bin/magento cache:flush</code> |
====Disabling debug logging==== | ====Disabling debug logging==== | ||
− | : <code>php bin/magento config:set | + | : <code>php bin/magento config:set --enable-debug-logging=false && php bin/magento cache:flush</code> |
#* Try running Magento and then check those log files - the default location is {{folder|/var/log}} | #* Try running Magento and then check those log files - the default location is {{folder|/var/log}} | ||
#* Add a number to the log filenames to see recent messages only. | #* Add a number to the log filenames to see recent messages only. | ||
# Next, check your server log files for errors (location will depend on your server - look for php and server log files). | # Next, check your server log files for errors (location will depend on your server - look for php and server log files). | ||
− | |||
===Check file ownership permissions=== | ===Check file ownership permissions=== | ||
Line 307: | Line 635: | ||
#: <code>php bin/magento module:disable Moogento_Core --clear-static-content</code> | #: <code>php bin/magento module:disable Moogento_Core --clear-static-content</code> | ||
#: ^ ''Don't do this step if you want to leave other Moogento plugins running!'' | #: ^ ''Don't do this step if you want to leave other Moogento plugins running!'' | ||
+ | #: *Or*, disable all in one line: | ||
+ | #::<code>php bin/magento module:disable Moogento_Core Moogento_License Moogento_Shipeasy</code> | ||
# Recompile: | # Recompile: | ||
#: <code>php bin/magento setup:di:compile</code> | #: <code>php bin/magento setup:di:compile</code> | ||
Line 336: | Line 666: | ||
# Clear cache and indexes and log out/in | # Clear cache and indexes and log out/in | ||
+ | '''Then in your DB:''' | ||
+ | # Find the `setup_module` in your db | ||
+ | # Find the entry for the Moogento module(s) you want to remove | ||
+ | # Delete those entries | ||
+ | # Find the `core_config_data` in your db | ||
+ | # Search path for '%LIKE% moogento' | ||
+ | # Select the relevant entries and delete | ||
+ | #: ''^ this will delete your saved config settings for the module(s)'' | ||
==="How long will it take to investigate and fix my issue?"=== | ==="How long will it take to investigate and fix my issue?"=== | ||
Line 343: | Line 681: | ||
We can't begin the work (or the ETA timer) until we have correct access details, so please make sure you send correct ones. | We can't begin the work (or the ETA timer) until we have correct access details, so please make sure you send correct ones. | ||
− | |||
− | |||
− | |||
It takes time to properly investigate bug reports, and plan feature requests, and we're a small team - we go as fast as we can but please don't expect magical instant development work :) | It takes time to properly investigate bug reports, and plan feature requests, and we're a small team - we go as fast as we can but please don't expect magical instant development work :) | ||
Line 357: | Line 692: | ||
If you're worried that you've been hacked and have some unauthorised code, the easiest way to check these specific files is to compare that code with the same file from the extension zip, downloaded from your Moogento account. Note that this code will sometimes change between versions, so make sure you're comparing the same version. | If you're worried that you've been hacked and have some unauthorised code, the easiest way to check these specific files is to compare that code with the same file from the extension zip, downloaded from your Moogento account. Note that this code will sometimes change between versions, so make sure you're comparing the same version. | ||
+ | |||
+ | ====Having issues opening or unzipping with Windows?==== | ||
+ | Using "Windows Defender" and it's blocking a download? | ||
+ | |||
+ | #Click "Internet Options" in the 'All Control Panel Items' window | ||
+ | #Click the "Security" tab | ||
+ | #Click the "Default Level" button (Medium-High) | ||
+ | #Click the "Custom Level…" button | ||
+ | #Scroll down to "Downloads", then click the "Enable" radio button | ||
+ | #Click the "OK" button to save changes | ||
+ | #Click "OK" again to close the 'Internet Options' dialog | ||
+ | |||
+ | Is Windows blocking an unzip? | ||
+ | |||
+ | #Right-click on the file | ||
+ | #Select Properties | ||
+ | #(Make sure you are in the General tab) | ||
+ | #Select the Unblock button | ||
+ | #Click Apply/OK and exit | ||
+ | #The file will be unblocked | ||
+ | |||
+ | Or try this: | ||
+ | #Click to the Windows Security Dashboard | ||
+ | #:[[File:windows-magento-unzip-error-security-dashboard-1.png|link=|600px]] | ||
+ | #Go to 'Virus & threat protection' | ||
+ | #:[[File:windows-firewall-network-protection.png|link=|600px]] | ||
+ | #Click 'Manage settings' | ||
+ | #:[[File:update-windows-virus-settings.png|link=|600px]] | ||
+ | #Disable 'Real-time protection' | ||
+ | #:[[File:disable-realtime-protection-windows.png|link=|600px]] | ||
+ | #You should now be able to unzip the download. | ||
+ | #When complete, don't forget to re-enable this setting. | ||
+ | |||
=="I stilll have issues!"== | =="I stilll have issues!"== | ||
− | * [ | + | * [https://moogento.com/contacts Drop us a line] with: |
# your (S)FTP & SSH access details | # your (S)FTP & SSH access details |
Latest revision as of 07:18, 25 January 2023
Contents
- 1 Magento Help
- 1.1 "After install I get 'Fatal error: Uncaught Error: Call to a member function getNext() on null in Interceptor.php'"
- 1.2 "After install I get a '500 Internal Server Error' in the browser"
- 1.3 "After install I get a fatal error, with 'Unable to retrieve deployment version of static files from the file system' in the reports"
- 1.4 "When entering the license key, it spins and doesn't save"
- 1.5 "After install I get images missing, or a server error: 'Forbidden: PHP is disable.'"
- 1.6 "I see an unstyled admin page"
- 1.7 "I get this error: 'The following modules are outdated'"
- 1.8 "When I activate a plugin, I get a 'circular dependency' error in admin"
- 1.9 "Running compile hangs with no errors"
- 1.10 "I get an error like 'Base table or view not found: (eg. moogentoshipeasycolumn) doesn't exist'"
- 1.11 "I see empty tables in the plugin config page"
- 1.12 "I get this error: 'Exception Printing is Disabled by Default for Security Reasons'"
- 1.13 "The Moogento license & config sections go blank & I get this error: '(Zend_Http_Exception): Invalid header line detected : Zend_Http_Response::extractHeaders'"
- 1.14 "When loading the Orders or Catalog page, I see a 'server error', or 'Attention: Something went wrong', but only with a specific user"
- 1.15 "When loading the Orders or Catalog page, after an upgrade, some interactive parts don't work"
- 2 PickPack (M2):
- 2.1 "After install I get a 'Unknown module(s): 'Moogento_PickPack' error"
- 2.2 "The admin user is logged out when trying to print PDFs."
- 2.3 "After install I see missing images or strange formatting in the PDF editor"
- 2.4 "I see text links instead of nice images!"
- 2.5 "When compiling a plugin, I get: 'Class 'PHPUnit\Framework\TestCase' not found in ... mPDFTest.php'."
- 2.6 "The printed date doesn't match the date showing in the Orders page"
- 2.7 "I'm using Magento 2.2.7 and having email-related errors"
- 2.8 "I get this error: 'Class Zend\Mime\PartFactory does not exist in [Moogento\PickPack\Mail\Template\TransportBuilder\Interceptor]'"
- 2.9 "I get this error: 'Warning: file_put_contents(/var/tmp/moogento/pickpack/pdf.html): failed to open stream: No such file or directory'"
- 2.10 "I get this error: 'Fatal error: Interface 'Magento\Framework\Filter\SimpleDirective\ProcessorInterface' not found'"
- 2.11 "I get this error: 'libpng warning: iCCP: known incorrect sRGB profile'"
- 2.12 "I get this error: 'libpng warning: Interlace handling should be turned on when using png_read_image'"
- 3 ShipEasy (M2):
- 3.1 "When installing, after running compile on production, I get an error 'The directory /var/generation cannot be deleted'"
- 3.2 "After install I see a spinning wheel in the Orders page which doesn't go away"
- 3.3 "When triggering emails (eg. via Ship & Invoice), we have issues."
- 3.4 "When editing a shipping address from the orders page (by clicking the pencil icon) I get an error."
- 3.5 "The Orders page doesn't work correctly with the Amasty 'Extended Order Grid' module installed"
- 3.6 "After updating I get an error: 'Column with key moo_shipeasy_ordertag_1 does not exist'"
- 3.7 "After installing ShipEasy some column options are missing and/or the ShipEasy config customise columns table is truncated"
- 4 StockEasy (M2):
- 5 Pick-n-Scan (M2):
- 6 "I still have issues"
- 7 "I stilll have issues!"
Magento Help
Something unexpected happened?
Try not to worry too much, take a deep breath and read through these common issues and solutions below.
Most issues have been seen before and are quickly fixable or at least revertible-from.
"After install I get 'Fatal error: Uncaught Error: Call to a member function getNext() on null in Interceptor.php'"
- Check that you've run setup:di:compile, from the Magento root:
php bin/magento setup:di:compile
- If that doesn't work right away, we can get a bit deeper:
php bin/magento maintenance:enable
rm -rf generated/ var/view_preprocessed/ var/composer_home/cache/ var/cache/ var/page_cache/
php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento setup:static-content:deploy -f
php bin/magento cache:flush
php bin/magento maintenance:disable
"After install I get a '500 Internal Server Error' in the browser"
- Check your server error logs first:
- Where this is will depend on your server. Here's some common examples:
- Centos: {server root}/var/log/httpd/
- Debian, Ubuntu: {server root}/var/log/apache2/
- MAMP: {Applications}/MAMP/logs/php_error.log apache_error.log
- MageMojo: /home/log/apache/error.log
- Access eg. via
nano /var/log/httpd/apache_error.log
- If the error isn't apparent in those logs, you might have some old static content that needs a tickle:
- Move pub/static/.htaccess somewhere out of that folder
- Delete /pub/static :
rm -R pub/static
- Run
php bin/magento setup:static-content:deploy
- Replace .htaccess in pub/static
- Or in one line:
php bin/magento maintenance:enable
mv pub/static/.htaccess pub/.htaccess
rm -R pub/static
php bin/magento setup:static-content:deploy
mv pub/.htaccess pub/static/.htaccess
php bin/magento maintenance:disable
- If that didn't help, you might have some old composer files causing issues.
- Delete /vendor :
rm -R vendor
- Run
composer update
- Delete /vendor :
"After install I get a fatal error, with 'Unable to retrieve deployment version of static files from the file system' in the reports"
Try running:
php bin/magento setup:static-content:deploy
"When entering the license key, it spins and doesn't save"
- Check that you have the openssl_public_encrypt PHP function enabled on your server
- Some dev servers have this off by default
- Also check the system logs in var/logs
- Finally check your server log files to see what's happening
If those don't resolve the issue, get in touch and we'll check it out.
"After install I get images missing, or a server error: 'Forbidden: PHP is disable.'"
- Open /pub/static/.htaccess
- Prefix the middle lines here with a # (to comment them out):
<IfModule mod_php5.c>
php_flag engine 0
</IfModule&dt;
<IfModule mod_php7.c>
php_flag engine 0
</IfModule&dt;
- So they look like this:
<IfModule mod_php5.c>
#php_flag engine 0
</IfModule&dt;
<IfModule mod_php7.c>
#php_flag engine 0
</IfModule&dt;
- Also check the correct magento file permissions are set
"I see an unstyled admin page"
Seeing some plainer-than-usual displays?
You might have some older static content that needs re-creating.
Try:
php bin/magento setup:static-content:deploy -f
"I get this error: 'The following modules are outdated'"
It might also say Moogento_{module} db schema version: defined in codebase - {v1), currently installed - {not v1).
- Load up your Magento database, eg. in phpMyAdmin
- Find the {possible_prefix_}setup_module table
- Find the entry relating to the module mentioned, eg. 'Moogento_Pickpack'
- Delete that entry
- Run
bin/magento setup:upgrade
to recreate the correct line
"When I activate a plugin, I get a 'circular dependency' error in admin"
If you see this, your install hasn't completed correctly.
Try this:
- Check you've registered all your dev & live domains in your Moogento account for the correct key.
- Backup your site files & database
- Enable Maintenance Mode.
- Re-copy all plugin files from the latest version.
- Check there's not multiple admin users logged in.
- Reset the install tag, according to this method.
- Remove generated files (see here for details):
rm -rf generated/metadata/* generated/code/* vendor/* var/cache/* var/generation/* var/view_preprocessed/* var/page_cache/* pub/static/frontend/* pub/static/adminhtml/* -R
- Update composer (re-generate the /vendor folder):
composer update
php bin/magento setup:upgrade
- Compile (re-generate files):
php bin/magento setup:di:compile
- Set file & folder permissions:
find . -type f -exec chmod 644 {} \;
find . -type d -exec chmod 755 {} \;
- Check the file ownership. You should have a specific server user (not root) that runs magento.
- eg. if that user is 'magento_user:
chown -R magento_user:magento_user *
- Update Magento db:
php bin/magento setup:db-schema:upgrade
- Reindex & clear caches:
php bin/magento indexer:reindex
php bin/magento cache:clean && php bin/magento cache:flush && php bin/magento cache:enable
- Disable maintenance mode:
php bin/magento maintenance:disable
"Running compile hangs with no errors"
Part of running Magento 2 stores is running compile (including when installing plugins):
bin/magento setup:di:compile -vvv
but, sometimes this hangs with no indication what's up.
There's a couple things we can do.
- Try with '-vvv' to show more info
bin/magento setup:di:compile -vvv
- In app/bootstrap.php around line 11, enable
ini_set('display_errors', 1);
then re-run compile.
"I get an error like 'Base table or view not found: (eg. moogentoshipeasycolumn) doesn't exist'"
This generally means there's a mismatch in tables in the database.
The cause is usually an incomplete install, if you skipped updates over a long time period, and sometimes from trying to use an extension without registering the license key.
The solution is to restart the module install in Magento, by removing the entry from the 'setup_module' table in your db.
eg. for M2 stockEasy the line is 'Moogento_Stockeasy'. Just remove that line and re-run the M2 database setup command.
- Delete the relevant line from setup_module, eg:
- Run the db update command:
php bin/magento setup:upgrade
Removing db entries for the plugins will remove settings related to that plugin
- * If you have specific settings saved to the plugin that you want to keep, export the relevant tables/entries first
- * After re-install you can then import/replace the relevant entries
Suggestions
These are not required, but to keep the db trim, it can be a good idea.
- If you're restarting the install, removing tables related to the same plugin at the same time can be a good way to get a fresh setup.
- * Recent Moogento plugins will usually name the tables like {moogento}_{plugin}_{specific} eg. moogento_stockeasy_columns
- * eg. SQL:
SHOW TABLES LIKE "%moo%"
- ^ Don't delete all entries unless you're re-installing *all* moogento modules!
- Also remove entries from core_config_data
- * Recent Moogento plugins will usually name the entries like {moogento or moo}_{plugin}/{specific} eg. moogento_stockeasy/grid_colors
- * eg. SQL:
SELECT * FROM `mg_core_config_data` WHERE `path` LIKE '%moo%' ORDER BY `path` DESC
- ^ Don't delete all entries unless you're re-installing *all* moogento modules!
"I see empty tables in the plugin config page"
If you've been updating the module, something might have gone sideways - try restarting the install.
Just log in to your database (eg. using phpMyAdmin) and find the setup_module table. Search for the line related to the plugin (eg. LIKE %stockeasy%
) and delete it, then run the M2 database upgrade:
php bin/magento setup:upgrade
"I get this error: 'Exception Printing is Disabled by Default for Security Reasons'"
This means that you're set to hide errors; this is recommended for production sites, but for developing a site it's helpful to see errors.
In app/bootstrap/index.php and /index.php set this (uncommented) at the top of the file:
ini_set('display_errors', 1);
"The Moogento license & config sections go blank & I get this error: '(Zend_Http_Exception): Invalid header line detected : Zend_Http_Response::extractHeaders'"
This is a bug in older Magento versions which had issues with http2 responses. Here's the fix (once you're updated to M2.3.3+ you can remove the fix):
1. In /composer.json, add:
composer.json "autoload": {
...
"files": [
...
"lib/Zend/Http/Response.php"
]
}
It'll then look something like this:
2. Copy
vendor/magento/zendframework1/library/Zend/Http/Response.php
to
lib/Zend/Http/Response.php
3. In that file, edit these lines:
[Line 185]
if (! preg_match('#^\d|\d(\.\d)*$#', $version)) {
[line 517]
if ($index === 0 && preg_match('#^HTTP/\d(?:\.\d+)* [1-5]\d+#', $line)) {
4. Run composer dump-autoload
"When loading the Orders or Catalog page, I see a 'server error', or 'Attention: Something went wrong', but only with a specific user"
First try logging in as a different user. This error is usually a result of some corruption in the table that records user-specific grid settings (filters, columns etc.), so changing user can get you out of a fix in the short term.
For a deeper solution, try clearing the ui_bookmark table.
To do this, you need to:
- Access your database (eg. in cPanel you can click 'phpMyAdmin', then the database you're using for Magento 2)
- Browse that ui_bookmark table; this is where user-specific filters, column setup, column sorts, are stored
- You'll see user_id as a column - you can either find the specific user id you need to clear, or just clear the lot
- To clear, select all the lines, then click 'Delete'
After this follow the instructions below on clearing your browser cache.
If you still have issues after this then you'll want to dig in and find the core issue.
"When loading the Orders or Catalog page, after an upgrade, some interactive parts don't work"
You've likely got some old javascript files cached locally - check that you've cleared your browser cache.
The easiest way to do this is:
- (In Chrome, similar in Edge, Firefox, Safari) right-click in the page > 'Inspect'.
- Then right-click the url refresh button, and 'Empty Cache & Hard Reload'.
PickPack (M2):
"After install I get a 'Unknown module(s): 'Moogento_PickPack' error"
If you've just ran:
php bin/magento module:enable Moogento_PickPack
and get that error message, then there's a few things to check:
- Have you uploaded pickPack files to the repo? :)
- Have you gone through our Install Guide?
"The admin user is logged out when trying to print PDFs."
This is a Magento issue, related to Github magento2: Issue #5309
Other users have suggested editing the .htaccess or conf file to something like this:
php_value session.cookie_lifetime 86400
php_value session.gc_maxlifetime 86400
and then setting the Admin Session timeout to 86400 in the admin config..
"After install I see missing images or strange formatting in the PDF editor"
Clear static files as above.
"I see text links instead of nice images!"
Have you recently cleared /pub/static ?
You're likely missing the /pub/static/.htaccess file. Just copy that back in (from another install if necessary).
"When compiling a plugin, I get: 'Class 'PHPUnit\Framework\TestCase' not found in ... mPDFTest.php'."
See this issue explained & resolved for one case here.
tldr;
Are you running Magento < 2.2 ?
Yes! Get in touch, you're a special case :)
No? Read on!
• You need PHPUnit version at least 6.x
• Install that via composer
Installing PHPunit
Try running composer install
and/or removing /vendor folder.
If you decide to remove that folder then you might use this command, inside your Magento root folder:
rm -rf vendor/*
And then get composer to reinstall those modules:
composer update
php bin/magento setup:upgrade
Recompile:
php bin/magento setup:di:compile
If you still have issues, check that your version is correct:
composer show -- phpunit/phpunit
If that's still showing a version less than 6.5, try going into the Moogento_Core and running update:
cd app/code/Moogento/Core
composer update
Also check, if you're running different PHP versions (eg. on local maybe using MAMP and a central PHP version) that you can access phpunit:
phpunit --version
^ If this returns an error then probably the easiest thing to do is install phpUnit:
wget https://phar.phpunit.de/phpunit-6.5.phar
chmod +x phpunit-6.5.phar
sudo mv phpunit-6.5.phar /usr/local/bin/phpunit
And then check again:
phpunit --version
If you're running Magento locally, using something like MAMP:
1. Copy phpunit into /MAMP/bin/
2. Edit the bash profile:
nano ~/.bash_profile
then add this after other PATH lines:
export PATH=/Applications/MAMP/bin/php/php7.1.12/bin:$PATH
"The printed date doesn't match the date showing in the Orders page"
pickPack allows you to choose which date you want to print:
- Printed date
- Ordered date
- Invoiced date
- Credited date
- Shipment date
Just:
- Edit the page you're after
- Click the 'Free text' block that you want to add a date to
- Place the cursor in the text field for that block, where you want to add the date
- Click the type of date you want to add
- Save
- Note you can set the way the date is formatted (eg. '1/2/19', '1st Feb 2019', etc) in the pickPack General config.
"I get this error: 'Class Zend\Mime\PartFactory does not exist in [Moogento\PickPack\Mail\Template\TransportBuilder\Interceptor]'"
If you're running a version of Magento less than 2.2.8, there's a quick command you need to run.
- Run this command in your main Magento install folder:
composer require zendframework/zend-mime
- Follow with the usual Magento update commands.
"I get this error: 'Warning: file_put_contents(/var/tmp/moogento/pickpack/pdf.html): failed to open stream: No such file or directory'"
You've got some permission or ownership issue with your setup (pickPack can't write its temp files while creating the PDFs).
It's time to check Magento 2 file ownership & permissions.
"I get this error: 'Fatal error: Interface 'Magento\Framework\Filter\SimpleDirective\ProcessorInterface' not found'"
Please upgrade to Magento 2.3.4+
If you need to run <2.3.4 feel free to get in touch and we can get it working for you.
"I get this error: 'libpng warning: iCCP: known incorrect sRGB profile'"
"I get this error: 'libpng warning: Interlace handling should be turned on when using png_read_image'"
These are core issues in PHP that are still present in PHP8:
https://github.com/libgd/libgd/issues/295
https://bugs.php.net/bug.php?id=71316
The cause is your catalog having some images saved as png format (we recommend jpeg), and then having those images also saved (eg via Photoshop) with a color profile attached, or saved as interlaced format.
You're likely to encounter other issues elsewhere with these images so our recommendation is to re-process them:
- ideally as jpegs
- or, re-process them with no color profile and not interlaced pngs
ShipEasy (M2):
"When installing, after running compile on production, I get an error 'The directory /var/generation cannot be deleted'"
Re-generate static content:
php bin/magento setup:static-content:deploy
- If your store isn't in English try this, in this order (eg. here for a French store):
php bin/magento setup:static-content:deploy en_US fr_FR
"After install I see a spinning wheel in the Orders page which doesn't go away"
Your install may not have completed correctly.
"When triggering emails (eg. via Ship & Invoice), we have issues."
If you're running 2.3.4+, it's stricter when processing templates - check that you don't have incomplete IF clauses in templates.
- Try re-running the installation compile commands.
- Check that your file & folder permissions are correct:
- The Magento file system user should have full control (read/write/execute) of all files and directories
- That user must not be the same user as the web server user
- The web server user must have write access to these files and folders:
- /var app/etc
- /pub
- /generated (since 2.2.1)
- The web server user group must own the Magento file system so the Magento user (who's in that group) can share file access with the web server user.
- (Including files created by the Magento Admin or other web-based utilities)
cd {root Magento folder}
find . -type f -exec chmod 644 {} \;
find . -type d -exec chmod 755 {} \;
find ./var -type d -exec chmod 777 {} \;
find ./pub/media -type d -exec chmod 777 {} \;
find ./pub/static -type d -exec chmod 777 {} \;
chmod 777 ./app/etc
chmod 644 ./app/etc/*.xml
chown -R :{web server group} .
chmod u+x bin/magento
- Then clear the caches:
php bin/magento cache:clean && php bin/magento cache:flush && php bin/magento cache:enable
"When editing a shipping address from the orders page (by clicking the pencil icon) I get an error."
If you've recently updated, please check you've still got the custom address parts selected in the shipEasy config.
"The Orders page doesn't work correctly with the Amasty 'Extended Order Grid' module installed"
Aka Amasty_Ogrid.
Download and install this patch:
https://moogento.com/downloads/ShipeasyAmastyOgridCompatible.zip
The grid should now load correctly.
"After updating I get an error: 'Column with key moo_shipeasy_ordertag_1 does not exist'"
In ShipEasy Config -> [Orders Page: Columns] find the entry for 'OrderTag: 1'. If the Options box is empty, add some options, eg:
Alert Flag|flag_alert.svg,
Tick|flag_tick.svg,
Cross|flag_cross.svg
Likewise check 'OrderTag: Printed' - if that options box is empty add the default options:
Printed|printed|#f0dba6,
Auto|auto|#f0dba6,
New|new|#e5f3d4
"After installing ShipEasy some column options are missing and/or the ShipEasy config customise columns table is truncated"
This sometimes happens if the site wasn't put in maintenance for install, or there were some missing files or some other issues that affected the smooth install.
Execute this SQL and then run the setup:upgrade commands:
DELETE FROM `patch_list` WHERE (`patch_name` LIKE '%Moogento\\\\Shipeasy\\\\Setup\\\\Patch\\\\Data\\\\PopulateDefaultColumns%');
This would normally trigger re-adding default columns to the ShipEasy custom column table.
StockEasy (M2):
"When installing and running update, I get an error 'Uncaught Error: Cannot instantiate interface'"
Try this:
rm -rf var/page_cache var/cache var/composer_home var/generation generated/code generated/metadata var/di var/view_preprocessed/*
redis-cli FLUSHALL
If you're running redis but that command doesn't show a result, then you should check with your host the correct command to use.
Pick-n-Scan (M2):
"I want to always launch the app in fullscreen"
Pick-n-Scan has an option in Config to show a 'fullscreen' button, which then shows up in the 'hamburger' menu.
Once clicked, the app will go fullscreen and you'll have more vertical space.
If you'd like to launch this fullscreen - this can make sense for warehouse scanning devices - then you just need to 'save to homescreen' the relevant url.
Here's the steps to add the homescreen shortcut on Chrome (other browsers will be similar) on Android (iOS is also similar):
1. Launch "Chrome" app.
2. Open the URL you want to pin to your home screen (ie. navigate to the scan screen from the Orders page)
3. Tap the menu icon (3 dots in upper right-hand corner) and tap 'Add to homescreen'.
4. You'll be able to enter a name for the shortcut (eg. "Pick-n-Scan") and then Chrome will add it to your home screen.
5. Now when launching the url via clicking that new icon, it should launch fullscreen (with no address bar).
"I still have issues"
Check you're using a supported version of PHP & Magento
- Check which version of PHP your version of Magento supports
- If you're not running a supported version, pause the install and consider changing your installed PHP version
- Open up {plugin}/composer.json and check the PHP & Magento versions that are supported match what you're running
Check log files
Your Magento 2 debug log file should be located here:
- var/log/debug.log
If you haven't turned on logging do so now.
Enabling debug logging
Via Admin backend
- Stores -> ConfigAdvanced -> Developer Debug -> "Log to File"
Via CLI
php bin/magento config:set --enable-debug-logging=true && php bin/magento cache:flush
- If you get a --lock error then try this:
php bin/magento config:set --lock --enable-debug-logging=true 1 && php bin/magento cache:flush
Disabling debug logging
php bin/magento config:set --enable-debug-logging=false && php bin/magento cache:flush
- Try running Magento and then check those log files - the default location is /var/log
- Add a number to the log filenames to see recent messages only.
- Next, check your server log files for errors (location will depend on your server - look for php and server log files).
Check file ownership permissions
If you didn't get this done when setting up Magento, or installed the plugin under a server user that's not the one that owns the Magento files, you might need to check this.
Check Magento 2 File Ownership and Permissions
Disabling extensions
Still problems? Let's turn it off:
- Disable the extension :
php bin/magento module:disable Moogento_PickPack --clear-static-content
- Disable other Moogento code if you like:
php bin/magento module:disable Moogento_License --clear-static-content
php bin/magento module:disable Moogento_Core --clear-static-content
- ^ Don't do this step if you want to leave other Moogento plugins running!
- *Or*, disable all in one line:
php bin/magento module:disable Moogento_Core Moogento_License Moogento_Shipeasy
- Recompile:
php bin/magento setup:di:compile
- Update the db:
php bin/magento setup:upgrade
- Clear caches:
php bin/magento cache:clean && php bin/magento cache:flush
Removing extensions
Need to remove all files related to our plugins?
Don't forget to drop us a line if something is going wrong, as we can usually help :)
Via CLI:
- Disable the plugins first, as per above
- Navigate to the Moogento parent folder:
cd /app/code/Moogento/
- Check what's there:
ls
- Remove the plugin folder:
rm -rf {extension name: eg. PickPack}
- Clear cache and indexes and log out/in
Via FTP:
- Disable the plugins first, as per above
- Download the latest version you have access to from your account
- Compare those files and folder structure with what you have installed
- Remove those files, starting with /app/code/Moogento/{plugin name}
- Clear cache and indexes and log out/in
Then in your DB:
- Find the `setup_module` in your db
- Find the entry for the Moogento module(s) you want to remove
- Delete those entries
- Find the `core_config_data` in your db
- Search path for '%LIKE% moogento'
- Select the relevant entries and delete
- ^ this will delete your saved config settings for the module(s)
"How long will it take to investigate and fix my issue?"
If you've got in touch with a issue or custom work request, we'll get back to you with a rough ETA.
We do all work in the order that they come in, with some sorting based on the Maintenance Plan you're on.
We can't begin the work (or the ETA timer) until we have correct access details, so please make sure you send correct ones.
It takes time to properly investigate bug reports, and plan feature requests, and we're a small team - we go as fast as we can but please don't expect magical instant development work :)
Also worth bearing in mind that we respond to support requests ourselves, so if you email every day for an update then you'll be directly slowing down your issue resolution.
"I found some encrypted portions of code, have I been hacked?"
All our code is open for you to edit.
We do have a couple of small blocks of encrypted code which are part of our licensing system. These need to be left unedited for your extension to work.
If you're worried that you've been hacked and have some unauthorised code, the easiest way to check these specific files is to compare that code with the same file from the extension zip, downloaded from your Moogento account. Note that this code will sometimes change between versions, so make sure you're comparing the same version.
Having issues opening or unzipping with Windows?
Using "Windows Defender" and it's blocking a download?
- Click "Internet Options" in the 'All Control Panel Items' window
- Click the "Security" tab
- Click the "Default Level" button (Medium-High)
- Click the "Custom Level…" button
- Scroll down to "Downloads", then click the "Enable" radio button
- Click the "OK" button to save changes
- Click "OK" again to close the 'Internet Options' dialog
Is Windows blocking an unzip?
- Right-click on the file
- Select Properties
- (Make sure you are in the General tab)
- Select the Unblock button
- Click Apply/OK and exit
- The file will be unblocked
Or try this:
- Click to the Windows Security Dashboard
- Go to 'Virus & threat protection'
- Click 'Manage settings'
- Disable 'Real-time protection'
- You should now be able to unzip the download.
- When complete, don't forget to re-enable this setting.
"I stilll have issues!"
- Drop us a line with:
- your (S)FTP & SSH access details
- Magento admin access
- which version of Magento
- which PHP version
- which Moogento plugin & version
- Before getting in touch, please:
- turn on Magento logging,
- turn off Magento compilation,
- provide details of any opcode or db cache systems and their logins,
- provide the path to your server log files
- include your order id or license key
"How do I give you Magento access?"
Tried all the suggestions above and need us to take a look? Not sure how to do that?
- Log into your Magento site
- Copy the URL from the browser and add it to your email to us.
- Next go to SystemPermissionsUsers > Add New User
- Make a username and password and add that to the email to us.
- then click User Role in the left column and assign us the role of Administrator.
Done!
"Where do I find the license key?"
We need your order id or license key before we can help with support. Because, you know. :)
- Go to SystemConfigurationMoogento -> (the extension you want help with, eg. pickPack)
- Click the 'License' section at the top of the page to expand it.
- Copy the value from the 'License Key' field.
- Paste that in your email that to us.