Landing Page Module for Magento
TABLE OF CONTENTS Table of Contents Table Of Contents... 2 1. INTRODUCTION... 3 2. Overview... 3 3. Requirements... 3 4. Features... 3 5. Installation... 4 5.1 Implementation... 4 5.2 Manual Installation...5 6. Configuration... 5 6.1 Enable Landing Page Extension...5 6.2 Managing Frontend of the extension Page...6 6.3 Extension Frontned...7 6.4 Create New Landing Page...9 7. Technical Information...10 8. Un-installation...10 9. Unsupported Features & Known Issues...11 10. Troubleshooting... 11
1. INTRODUCTION This document is intended as a technical resource for the installation, setup and use of the Landing Page Module for Magento. Landing Page is plug& Play extension compatible with Magento community version 1.6,1.7 & 1.8. This extension is an enforcer to enhance your store sale! Using the extension you can showcase the high performing products which in turn would boost your sales and increase the revenue 2. Overview Magento is an open source e-commerce CMS that uses a LAMP (Linux, Apache, MySQL, PHP) architecture. As an open source platform, the modifications one could make to their website are limitless. With this in mind the integration was developed to incorporate as close to core Magento API functionality as possible. By installing Landing page in your website you can create good landing pages with selected products, text information & banners. Customers can quickly find the products they are interested in, without a need to browse through the whole catalog 3. Requirements 1. Magento Community Edition v1.6 & Above 2. Landing Page Extension Module from Magento Connect 3. Magento Administrative Privileges 4. Features This is a Third Party Module to integrate with Magento 1. Can create landing pages to show best products of stores. 2. Can add banner, text information& products to landing page. 3. Can define search keywords for a particular landing page, to fetch all those products that are related to the keywords. 4. It has the feature to directly import& Export the landing pages Import/ Export Feature Refer to the Top navigation bar->perficient Extension->Landing Pages-> Import/export Pages
Figure 4-1 Export Landing Pages: User can export all landing pages that are currently available in website. It will give you a CSV file. You can also refer same file format while importing as, it gives the standard format to import lading pages. Import Landing Pages: With this feature user can create new lading pages, as well as update existing landing pages. Note: File should be in proper format. Otherwise records will not get update properly. Take export of landing pages to know the correct format. If you provide Landingpage_id in sheet, it will try to update the record with the same id. If you want to insert new record, leave this field blank. If you try to insert any new Landingpage_id via CSV sheet which is not present in database it will give you error. Note: Title & Identifier is unique throughout a store. Also it should follow proper naming convention Figure 4-2 5. Installation 5.1 Implementation Steps to Install This Module Prior to install be sure you have read the requirements in Part 1. Install the Landing Page Module from Magento Connect 2. After the installation is complete, browse to your Magento homepage in order to complete the module install 3. After completion clear cache from admin, then log out from admin & login again. 4. You should now have a General and Frontend section in your Admin Panel under System>Configurations>Perficient Extensions>Landing pages 5. Enable Landing page Extension from General section.
6. Landing page is now enabled. You can create your landing pages, assign products to those & show in frontend. 7. You can configure frontend visibility from Frontend Section 5.2 Manual Installation Landing page extension recommends installing via Magento Connect rather than manually for a simpler implementation. Prior to install be sure that you have access to the Landing page on Demand service via an internet connection 1. Obtain a copy of the Landing page module 2. Unzip the Module files into a local directory. 3. Move all files into their respective directories in your Magento installation directory on the FTP server as they appear after unzipping the package. 4. Clear your store cache from Magento admin panel under System > Cache Management. 5. Log Out of your Magento Admin and then log back in. (This refreshes the Magento ACL date which effects your administrative permissions. You will not see expected module behavior until you do this. You may also need to refresh your cache.) 6. After all copying is complete browse to your Magento homepage in order to complete the module install 7. You should now have a General and Frontend section in your Admin Panel under System>Configurations>Perficient extensions>landing Pages 8. Enable Landing page Extension from General section. 9. Landing page is now enabled. You can create your landing pages, assign products to those & show in frontend. 10.You can configure frontend visibility from Frontend Section 6. Configuration All configurations are handled in the Magento Admin Panel. The Landing Page Configuration is located in Perficient Solutions->Landing Page->Manage Landing Page Settings AND System -> Configuration -> PERFICIENT EXTENSIONS->Landing Pages 6.1 Enable Landing Page Extension Once the installation is complete, Extension has a default behavior to enable itself. Though it can be managed i.e. enabled/ Disabled from admin console.
Perficient Solutions->Landing Page->Manage Landing Page Settings OR System -> Configuration -> PERFICIENT EXTENSIONS->Landing Pages [Refer Figure 6-1] Figure 6.1-0 6.2 Managing the Frond end of the Extension page Front end depiction of the extension can easily managed from Admin console Perficient Solutions->Landing Page->Manage Landing Page Settings OR System -> Configuration -> PERFICIENT EXTENSIONS->Landing Pages Section Front End can be used to configure the visibility at the user end Figure 6.2-0 1. Front Router name: Can change frontend router name from here,. Router name is used in URL of listing page. Note: If you change the frontend router name, then you will need to place new frontend router name in <url> tag in file \app\design\frontend\base\default\layout\perficient\landingpage.xml on line no. 31. 2. No. of columns: No. of columns to be shown in listing page.
3. Page items per Page on List allowed values: No. of pages to be show in listing page. 4. Page items per Page on List default value: Default value of Page items per Page. 5. Page Listing Sort by: Parameter to sort landing pages in listing page. 6. Banner Image: This image will be shown in listing page. 7. Default Title: Title for listing page. 8. Default Meta Keywords: Used for SEO purpose. Define important keywords here. 9. Default Description : It will be shown in listing page 6.3 Extension Front end Figure 6.3-1 Figure 6.3-1 shows the front end of the extension; at the extreme top of the page it carries the banner. Refer to the Red encircled as the landing pages which would take the user to the respective page. There could be n number of landing pages either manually added or CSV Imported. This page also carries the default Magento Sort By and Show per page. Figure 6.3-2 shows the actual Landing Page It shows the Landing Page Name, the description, Featured Products and thesearched Products
Figure 6.0-2
6.4 Create New Landing Page Landing pages can be created from the admin console. Navigate Perficient Solutions->Landing Page->Manage Landing Page Settings ORSystem -> Configuration -> PERFICIENT EXTENSIONS->Landing Pages->Manage Landing Pages Figure 6.0-1 Click Add Landing Page button to create new your Landing Page Figure 6.0-2 To create a new landing page you need to specify below fields: 1. Title: Title is name of your landing page, which will get displayed in frontend. On opening landing page list. Title is unique through a store. 2. Identifier: Identifier will be used in URL key of a landing page. It should be alpha-numeric or it can be set of characters only. It should always be in lower case. If you don t specify any identifier it will automatically create it by using title name. 3. Search: If you specify any word in search key world, & if that key word will contain by any product in product name, short description or description, that product will get listed in that landing page, in front
end. Multiple keywords can be defined for a landing page by separating with comma. For example, if you specify computer in search key word, then all product having word computer in product name will get assigned to that listing page. 4. Featured Products SKU: This field will contain all those SKUs that you want to assigned to particular Landing page. If no featured products will be defined still it will show the results for search keywords. 5. Short Description: It will get displayed in front end on particular landing page. It will contain a brief description of landing page. 6. Description: It will get displayed in frontend on particular landing page. This will contain details of landing page. 7. Sort Order: Sorting will be perform base on this number. If you want to put a page at the first assign 0. 8. Meta Keywords: Meta keywords help in search engine optimization. Put your most important word or phrases related to particular landing page. 9. Meta Description: Meta Descriptions, which are HTML attributes that provide concise explanations of the contents of web pages, are commonly used by search engines on search result pages to display preview snippets for a given page 7. Technical Information Following are the files required for the extension: The Landing Page module has the following components: Controllers: The Landing Page Module doesn t override any core controller functionality. Model : Contains all Model files providing data, service related to data and business logic. Block : Contains all block files which defines how to present data. Sql : This folder contain sql installation and upgrade files between module versions Data : Contains the data script to insert sample data. Database Table : Landing page has two tables perficient_landingpage & perficient_landingpage_store. Frontend: This module has below files for frontend: o \app\design\frontend\default\default\template\perficient\landingpage : Contains the template files o \app\design\frontend\default\default\layout\perficient\ : Contains the layout file Adminhtml: This module has below files for admin panel: o \ app\design\adminhtml\default\default\layout\perficient : Contains the layout file
8. Un-installation Below are the steps to un-install the application Remove design files from below folders o \app\design\frontend\default\default\template\perficient\ : remove the template files of landing page o \app\design\frontend\default\default\layout\perficient\ : remove the layout file landing page o \ app\design\adminhtml\default\default\layout\perficient : remove the layout file landing page Remove Module Activation file: o Remove perficient_landingpage.xml from \app\etc\modules\ folder Remove Module from Code : o Remove files form app\code\local\perficient\ of landing page. Remove Locale file : o Remove \app\locale\en_us\ Perficient_LandingPage.csv Remove Database tables : o Run below queries in database DELETE FROM `<prefix>core_resource` WHERE <prefix>core_resource.code = 'perficient_landingpage_setup' DELETE FROM `<prefix>core_config_data` WHERE <prefix>core_config_data.path LIKE '%perficient_landingpage%' DROP TABLE `<prefix>perficient_landingpage_store` DROP TABLE `<prefix>perficient_landingpage` 9. Unsupported Features & Known Issues Note: Frontend router name can be changed from System>Configuration>Perficient Extension>Landing Pages>Frontend Section. As router name is used in Url of listing page, if you change the frontend router name, then you will need to place new frontend router name in <url> tag in file \app\design\frontend\default\default\layout\perficient\landingpage. xml on line no. 31. Otherwise footer link for landing page will give you 404 page not found error page.
10. Troubleshooting Note: File should be in proper format. Otherwise records will not get update properly. Take export of landing pages to know the correct format. If you provide Landingpage_id in sheet, it will try to update the record with the same id. If you want to insert new record, leave this field blank. If you try to insert any new Landingpage_id which is not present in database it will give you error.