MagePlugins

The Best Extensions Backed By The Best Support Team

Overview

This Magento Extension makes it possible to accept offline payments through the administrative area. You'll be able to add a note to the payment and complete an order without processing anything online.

Customers on the frontend do not have the ability to place offline payments with this extension. They will not see any options for this method.

Administrators will see an option for "Walk In" and the ability to add a small note to the payment method.

Installation Procedure

You should never install an extension directly onto your production website. Please install this extension onto a staging version of your website and verify it's compatibility.

Taking Backups

Take a Backup Of Your Database

Most extensions will modify your database and some complex extensions will modify Magento's Db Tables. It's important that you take a backup of your website database before attempting an install.

To take a backup with Magento's built in backup tool, navigate to Admin Panel > System > Tools > Backups.

Database backup files are compressed using the .gz format. The .tgz format is used for system, database, and media backups. Backup files are stored in the var/backups directory in your Magento file system. The files that are stored in the /var/cache, /var/log, /var/session and /var/report folders are excluded from the backup.

To Create a Single Backup

1. Click one of the following buttons, depending on the type of backup you need to create:

  1. System Backup will create a .tgz of the entire source code and the database.
  2. Database and Media Backup will create a .tgz containing a database backup and the contents of the media directory
  3. Database Backup will backup only the database

2. When prompted that the backup will take time, click OK to continue.

3. To put the store into maintenance mode during the backup, select the checkbox. After the backup is created, maintenance mode is turned off automatically.

4. If you are creating a system backup, select the Include Media folder to System Backup checkbox if you want to include the media folder. When prompted, confirm the action.

All backups are listed on the Backups page. Deleting a record from the list deletes the archive file as well.

Take a Backup Of Your Database With Connect Manager

If the option above was not available to you, this option may be easier.

1. On the Admin menu, select System > Magento Connect > Magento Connect Manager.

2. Select the Create Backup checkbox and select the backup type.

3. Proceed with an extension installation or Magento update. The backup is created automatically and available at System > Tools > Backups.

Disable Magento Cache

1. From the Admin Panel, select System > Cache Management.

2. This will generate the Cache Storage Management panel. Click Select All.

3. From the Actions drop-down list select Disable > Submit.

4. To ensure the cache has been completely cleared, click Flush Magento Cache and Flush Cache Storage.

5. It's important that you disable server cache mechanisms such as APC Cache, Varnish Cache or even CDNs that are loading cached copies of your website. All of these caching mechanisms can cause unwanted effects during an installation, even crippling a database and forcing a developer to repair your store.

Disable Magento Compiler

1. Navigate to System > Tools > Compilation and click on then Disable button.

Enable Installation Logs

Enabling the Magento Error logs will provide us with an exact sequence of events that your store went through while attempting to install an extension. If everything goes to plan you can disable the logs, but if something breaks these logs will be indispensible to our recovery efforts.

1. From the Admin Area go to System > Configuration > Advanced > Developer > Log Settings.

2. Find the configuration option labeled Enabled and change the dropdown to Yes.

3. Click the Save Config button and wait for the page to reload. You have successfully enabled error logging and installation logs.

Download Your Purchased Extension

Immediately after your purchase you were provided with a download link of your new software. This download will contain one to many extension folders and documentation for each of the extensions.

If you did not download your software at the time of purchase you can log into your account with us and download copy. Your download will be available for 12 months following your purchase. If it has been 12 months since your last purchase you will need to purchase the software again to reactivate your download.

Log into your Mage Plugins customer account here, https://mageplugins.net/customer/account/.

In the left menu of your customer account choose My Downloadable Products. This will display a complete list of the products which you've purchased in the last twelve months. Click on the extension which you would like to install and your download will start.

Install The Extension

1. Copy The Extension Files. In the compressed archive which you downloaded you will see one to many extension folders. Within each of these folders is an exact replica of the Github Repository that we use for developing the extension.

You may delete/ignore any files that are UPPERCASE and/or end with .md. These files are relevant to development only.

The documentation files that you're reading right now exist under the /docs folder within each extension directory. You will receive this exact documentation when you purchase and download the extension. You may read these docs offline.

All other files and folders within each extension directory are important to the successful installation of your new software. Copy and paste, or drag these files into the WEBROOT of your magento installation.

Your extension files are now installed and your extension is ready to be installed into your database.

2. Access your Admin Area to complete the database installation procedure for your extension.

To confirm that your extension has installed, go to System > Configuration > Advanced > Advanced. The modules that you just copied the files for will be listed here if Magento is recognizing them.

3. Log Out and Log Back In Now that your extension has been installed, log out of your admin area and log back into it. Once you've completed this action you may re-enable the compiler, your magento cache and any other cache mechanisms that you had disabled.

Your installation is now complete.

Configuration Reference

To access the configurations for this extension navigate to
System > Configuration > Sales > Payment Methods > Walk In

Walk In
Field Type Description
Title string This is the Payment Method label that administrators will see when creating an order from the administrative area.
Creation Of Shipment dropdown Choosing Yes will cause a shipment to be created within Magento the moment that the order is placed. This will cause the product quantities to be deducted from the Magento inventory. A shipment will also cause the order status to be changed to completed.

Choosing No will prevent the inventory from being deducted and the order will be left in a Pending status until you manually create the shipment.

File Structure

The below table explains the Extension's file structure:

Path Description
app The extension's source code
code Contains the raw source code of PHP and configuration files
community community is typically reserved for extensions which were built for the magento community of store owners
MP All Mage Plugin developed extensions will exist under this directory
OfflinePayment Contains the backend programming specific to this extension
Block Backend programming files which contain the logical code for block functionality
Payment Blocks related to the payment method area in the admin
Form
Walkin.php Is the Payment Block which displays the payment form when creating an order from the admin
Info
Walkin.php When viewing an existing order this block will display the payment type and note
etc Directory contains the configuration settings for this extension
config.xml Contains configuration settings for Magento to locate the db tables related to this extension and for Magento to locate the extensions file structure when autoloading classes.
system.xml Provides directions for creating the configuration settings offered in the last section.
Helper Contains miscellaneous function classes for assisting objects
Data.php Standard help file with miscellaneous methods
Model Contains the database object classes which handle the reading, writing, updating and deleting records.
Order
Observer.php Contains event hooks which handle the payment processing requirements. This file also creates the shipment record if the configrations require it.
Payment
Method
Walkin.php File pulls the payment notes from the database
design Contains the html files specific to the installed themes
adminhtml Html files used within the administrative area
default
default
template
offlinepayment
payment Html files specific to this extension
form
walkin.phtml Contains the visual display of the payment form
info
walkin.phtml Contains the visual display of the payment notes that were entered for the order
etc Contains the configuration files which determine what database and modules are loaded by Magento
modules All extension activation files are located here
MP_OfflinePayment.xml Contains the activation and dependency configurations for this extension

Uninstallation Procedures

Prepare for Uninstallation

1. Disable Magento's Cache

2. Disable the Magento Compiler

3. Disable any caching mechanisms that are running on your server

Disable The Extension

1. Open the file app/etc/modules/MP_OfflinePayment.xml in a file editor.

2. Exchange the line

<active>true</active>

with

<active>false</active>

3. Delete the cache directory var/cache and this will disable the extension completely.

4. Verify that your webstore is operating properly without the extension by creating a sales order. You should not longer be able to see the admin offline payment option when creating an order.

5. If everything is operating properly you may delete the extension files which are outlined in the file structure above.

The Best Extensions Backed By The Best Support Team