Zen Cart How To Use The Developer’s Toolkit – Part Two

This Zen Cart tutorial is the second and final part of a series that explains what the developer’s toolkit is, and how it can be used to help with website customization. In this installment, we will pick up where we left off in the last segment.

If you have already picked the text you wish to modify, highlight it with your cursor. Then, paste that section exactly as is into the first search box on the developer’s toolkit page in your zen cart admin area. This is the part of the process that will vary depending on what change you are making, and where you are making it.

Next, open the first drop-down menu, and select the appropriate category. This will also be different from task to task. Since we are changing the welcome email text for this example, we will choose ‘All Language files’. Click search to display all the results for the criteria you just defined. Several files will likely be shown, along with the exact line numbers on which the text you are looking for can be found. For this example, the file we are looking for is /includes/languages/english/create_account.php.

Retrieve this file from your zen cart server, and open it in your favorite plain text editor. Make your changes, and save the file to your computer. Then, upload it to your server via FTP or SSH. It is recommended that you move the customized version of this file to an override directory, even though this isn’t where you got the file from. This means that instead of uploading the file back to /includes/languages/english/create_account.php, you would put it in
/includes/languages/english/YOURTEMPLATE/create_account.php. Replace the ‘YOURTEMPLATE’ folder name with the name of the directory you are using to develop your zen cart website.

If you need help with your zen cart web site please contact us for a quote.

zen cart plus picaflt sor azul equals success

Zen Cart How To Use The Developer’s Toolkit – Part One

The developer’s toolkit in zen cart is an advanced tool found in the zen cart admin area. It’s primary function is to list the zen cart files associated with or affecting various functions in your store. By using it, you can determine which file, or files you will need to modify to make a change in your zen cart store. It can save you a lot of time and trouble when making customizations to your website. In this Zen Cart Easy Help Tutorial, we will be taking a closer look at how you can use this tool when making customizations to your zen cart ecommerce store. For this purpose, we will walk you through the process of making a simple change to the welcome email text.

First of all, you will need to create an account on your own website, assuming that you do not already have one. This is something you should always have, whether you are a zen cart web developer, or just a store owner. Having an account on the website you are making changes to allows you to keep track of certain modifications, so that you know if your adjustments have actually gone into effect. This way, if something has gone wrong, you can troubleshoot the problem and get it fixed with minimal hassel.

Next, decide what you want to change. For this example, let’s say you want to rewrite, replace, or update the text in the welcome email that is sent out to customers when they sign up for an account on your website. After you have decided what you will be changing, open your zen cart admin area and log in. Then, navigate to the Tools-> Developers Tool Kit page.

If you need help with your zen cart web site please contact us for a quote.

zen cart plus picaflt sor azul equals success

Zen Cart How To Add Menu Items Into The Admin – Part Three

This Zen Cart tutorial is the last in a three part instructional series that teaches Zen Cart users and store owners how to add new items or tools into their admin menus. It should be noted that this exercise requires a certain proficiency in php and css.

The seventh and final parameter (20) is the sort order for the page. This determines it’s position within the drop-down menu in relative to the other items and tools.

After you have made the correct modifications, your new item should be present in the admin menu of your choice. In the future, if you decide you no longer want or need this item in your admin menu, removing it is a simple matter. All you have to do is incklude a file in your distribution named /uninstall_new_page.sql. This code should be contained in the file:


DELETE FROM admin_pages WHERE page_key='toolsNewTool';

Rather than distribute the init_new_tool.php file, you might consider include installation instructions for the Admin Access Management->Admin Page Registration tool. Set Page Key to toolsNewItem, the Page Name to BOX_TOOLS_NEW_ITEM, and the Page File Name to FILENAME_NEW_ITEM. Don’t put anything into Page Parameters.

After making the correct modifications, select “Tools” in the Menu. Check ‘Show on Menu’ , and set the Sort Order to 20. If you don’t see your newly added item after this, don’t panic. It’s probably just hiding somewhere in the midst of the menu’s dropdown. If you want to make sure that your item is at the bottom of the menu, then simply set the sort order to 999, or some other large number. If you want to change the position of an item within the menus, use phpMyAdmin to browse the admin_pages table. Find the menu item, and modify it’s sort_order value.

If you need help with your zen cart web site please contact us for a quote.

zen cart plus picaflor azul equals success

Zen Cart How To Add Menu Items Into The Admin – Part Two

This Zen Cart tutorial is the second in an instructional series aimed at teaching zen cart users and store owners how to add new items into their admin menus. As was noted in the last installment of this series, a certain amount of css and php knowledge is required to do this.

Now, in Zen Cart v1.5.0 and higher, you will have to include a file that looks something like this:

/YOUR_ADMIN/includes/functions/extra_functions/init_new_item.php


if (!defined('IS_ADMIN_FLAG')) {
    die('Illegal Access');
} 

//----
// If the installation supports admin-page registration (i.e. v1.5.0 and later), then
// register the New Tools tool into the admin menu structure.
//
// NOTES:  
// 1) Once this file has run once and you see the Tools->New Tool link in the admin
// menu structure, it is safe to delete this file (unless you have other functions that
// are initialized in the file).
// 2) If you have multiple items to add to the admin-level menus, then you should register each
// of the pages here, just make sure that the "page key" is unique or a debug-log will be
// generated!
//
if (function_exists('zen_register_admin_page')) {
  if (!zen_page_key_exists('toolsNewItem')) {
    zen_register_admin_page('toolsNewItem', 'BOX_TOOLS_NEW_ITEM', 'FILENAME_NEW_ITEM','' , 'tools', 'Y', 20);
  }    
}

The value ‘toolsNewItem’ should be unique, and is meant to identify the new tool you are inserting into the menu in your zen cart admin. The ‘BOX_TOOLS_NEW_ITEM’ and ‘FILENAME_NEW_ITEM’ values are being defined within the other files in your toolset. The empty set of (”) describes the parameters, if any, that your tool might require for operation. The fifth (‘tools’) is a variable that points to the menu items your tool will appear in(I.e., configuration, catalog, modules, etc.). The parameter marked in the example code as (‘Y’) specifies whether or not the new item will display as a page on the admin menu.

If you need help with your zen cart web site please contact us for a quote.

zen cart plus picaflor azul equals success

Zen Cart How To Add Menu Items Into The Admin – Part One

This Zen Cart tutorial will teach zen cart users and store owners how to add new items into the menus in your zen cart admin. This tutorial will show you how to modify zen cart’s code to implement new menu items, so it would be best if you had some basic knowledge of php/css, and the zen cart file structure before attempting this.

For this tutorial, we will assume that the new item you want to put into your zen cart admin menu is a tool called new_item.php, and you want to put it into the ‘tools’ menu. For this exercise, it should be noted that many of the files distributed in the new_item.zip file are identical to files that can be found in older versions of zen cart.

The first thing you need to do is familiarize yourself with some of the files you will need to work with.

/YOUR_ADMIN/new_item.php is the name of the file that will contain the code needed to implement your new admin tool.

/YOUR_ADMIN/includes/extra_datafiles/new_tool_filenames.php has the file name that will be used to define your new tool(e.g. define(I.e., ‘FILENAME_NEW_TOOL’, ‘new_item’)

/YOUR_ADMIN/includes/languages/english/extra_definitions/new_tool_name.php holds the menu entry text definition for the new tool(I.e., ‘define(‘BOX_TOOLS_NEW_TOOL’, ‘New Tool’))

/YOUR_ADMIN/includes/languages/english/new_tool.php is the file containing language-specific definitions for your tool. The name of the language file should match the name of the tool.

It is also important to remember that the file you distribute to, which will actually add new_item.php to the Tools menu, is different in zen cart v1.5.0 and higher than in older versions. In earlier versions of Zen Cart, the distributed file file is named /YOUR_ADMIN/includes/boxes/extra_boxes/newtool_tools_dhtml.php. this file contains this line of code:


$za_contents[] = array('text' => BOX_TOOLS_NEW_TOOL, 'link' => zen_href_link(FILENAME_NEW_TOOL, '', 'SSL'));

If you need help with your zen cart web site please contact us for a quote.

zen cart plus picaflor azul equals success

Zen Cart Admin Menu Guide – Configuration – Shipping/Packaging

Need a great zen cart template? View all of our instant download templates here:

Zen Cart Templates

The zen cart admin is packed with functionality. Here is a handy overview of all of the Admin – Configuration – Shipping/Packaging. General shipping information including locations, weight and size limits, etc.

zen cart admin menu guide

Configuration – Shipping/Packaging

  • Country of Origin: Set this to the country of origin to be used in shipping quotes.
  • Postal Code: Set this to the postal code of the store to be used in shipping quotes. For zip codes within the US, only use your five digit zip code.
  • Enter the Maximum Package Weight you will ship: Set this to the maximum weight limit for a single package.
  • Package Tare Small to Medium – added percentage:weight: Set this to define a percent of product weight as packaging. This is expressed as two numbers separated by a colon. First number is a % of the weight of that will be your small package weight. Second is your small package weight maximum or upper limit.
  • Larger packages – added packaging percentage:weight: Set this to define a percent of product weight as packaging. This is expressed as two numbers separated by a colon. First number is a % of the weight of that will be your large package weight. Second is your large package weight average or maximum or upper limit.
  • Display Number of Boxes and Weight Status: Options are: 0 = off, 1 = Boxes Only, 2 = Weight Only
    , 3 = Both Boxes and Weight.
  • Order Free Shipping 0 Weight Status: If there is no weight to the order is shipping free?
  • Shipping Estimator Display Settings for Shopping Cart: Set whether a shipping estimator link is displayed in the Shopping Cart or not. Options are: 0 = Off, 1 = Display as Button on Shopping Cart Page, 2 = Display as Listing on Shopping Cart Page.

If you need help customizing your zen cart web site, or would like a great custom design, please contact us for a quote.

zen cart plus picaflor azul equals success

Zen Cart Admin Menu Guide – Configuration – Customer Details

Need a great zen cart template? View all of our instant download templates here:

Zen Cart Templates

The zen cart admin is packed with functionality. Here is a handy overview of all of the Admin – Configuration – Customer Details. This menu controls which options will be included in the User Login/Registration page and also on the My Account page.

zen cart admin menu guide

Configuration – Customer Details

  • Email Salutation: Set this to true to display Email Salutation choice during account creation and with account information.
  • Date of Birth: Set this to true to display Date of Birth field during account creation and with account information.
  • Company:Set this to true to display Company field during account creation and with account information.
  • Address Line 2: Set this to true to display Address Line 2 field during account creation and with account information.
  • State: Set this to true to display State field during account creation and with account information.
  • State – Always display as pulldown?: When State field is displayed, should it always be a pulldown menu?
  • Create Account Default Country ID: The country that is set to default for the create account page.
  • Fax Number: Set this to true to display Fax Number field during account creation and with account information, set to true or false.
  • Show Newsletter Checkbox: Show Newsletter Checkbox during account signup. Can be set to either 0 (off), 1 (display unchecked) or 2 (display checked). Defaulting this to accepted may be in violation of certain regulations for your state or country.
  • Customer Default Email Preference: Set the customer default email preference. Can be set to either 0 (text) or 1 (HTML).
  • Customer Product Notification Status: Customer should be asked about product notifications after checkout success. Can be set to 0 (never ask) or 1 (ask, unless already set to global).
  • Customer Shop Status – View Shop and Prices: Set whether the customer must be approved to shop. If you wish customers to login to see prices, it is recommended that you use option 2 so that search engine spiders can index your pages. Options are: 0 = Not required, 1 = Must login to browse, 2 = May browse but no prices unless logged in, 3 = Showroom Only
  • Customer Approval Status – Authorization Pending: Set whether the customer must be authorized to shop. If you want a restricted shop, it is recommended that option 2 or 3 be used so that search engine spiders can index your pages. Options are: 0 = Not required, 1 = Must be Authorized to Browse, 2 = May browse but no prices unless Authorized, 3 = Customer May Browse and May see Prices but Must be Authorized to Buy.
  • Customer Authorization: filename: Customer authorization filename.
  • Customer Authorization: Hide Header: Hide the header before customer authorization.
  • Customer Authorization: Hide Column Left: Hide the left column before customer authorization.
  • Customer Authorization: Hide Column Right: Hide the right column before customer authorization.
  • Customer Authorization: Hide Footer: Hide the footer before customer authorization.
  • Customer Authorization: Hide Prices: Hide the product prices before customer authorization.
  • Customers Referral Status: Set if a customers referral code is created, and if so, how it is created. Once the customers referral code has been set it can only be changed in the Customer Admin. Options are: 0 = Off, 1 = 1st Discount Coupon Code used, 2 = Customer can add during create account or edit if blank.

If you need help customizing your zen cart web site, or would like a great custom design, please contact us for a quote.

zen cart plus picaflor azul equals success

Zen Cart Admin Menu Guide – Configuration – Images

Need a great zen cart template? View all of our instant download templates here:

Zen Cart Templates

The zen cart admin is packed with functionality. Here is a handy overview of all of the Admin – Configuration – Images settings. Here you can control the sizes of images on each page and type of content in your zen cart.

zen cart admin

Configuration – Images

  • Small Image Width: This controls the width of images in side boxes.
  • Small Image Height: This controls the heigth of images in side boxes.
  • Heading Image Width – Admin: The width, in pixels, of heading images in the Admin. This adjusts the spacing on the pages in the Admin pages or could be used to add images to the heading in the Admin.
  • Heading Image Height – Admin: The heigth, in pixels, of heading images in the Admin. This adjusts the spacing on the pages in the Admin pages or could be used to add images to the heading in the Admin.
  • Subcategory Image Width: The width, in pixels, of subcategory images.
  • Subcategory Image Height: The height, in pixels, of subcategory images.
  • Calculate Image Size: Set this to true if you want your image sizes to be calculated.
  • Image Required: Enable this to display broken images. A great tool for development.
  • Image – Shopping Cart Status: Set this to 1 to show product images in the Shopping Cart.
  • Image – Shopping Cart Width: The width, in pixels, of product images displayed in the Shopping Cart.
  • Image – Shopping Cart Height: The height, in pixels, of product images displayed in the Shopping Cart.
  • Category Icon Image Width – Product Info Pages: The width, in pixels, of category icons displayed on the Product Info pages.
  • Category Icon Image Height – Product Info Pages: The height, in pixels, of category icons displayed on the Product Info pages.
  • Product Info – Image Width: The width, in pixels, of product images displayed on the Product Info page.
  • Product Info – Image Height: The height, in pixels, of product images displayed on the Product Info page.
  • Product Info – Image Medium Suffix: Suffix for medium sized images.
  • Product Info – Image Large Suffix: Suffix for large sized images.
  • Product Info – Number of Additional Images per Row: Number of additional product images to display per row.
  • Image – Product Listing Width: The width, in pixels, of the product listing image.
  • Image – Product Listing Height: The height, in pixels, of the product listing image.
  • Image – Product New Listing Width: The width, in pixels, of the new product listing image.
  • Image – Product New Listing Height: The height, in pixels, of the new product listing image.
  • Image – New Products Width: The width, in pixels, of the new product image.
  • Image – New Products Height: The height, in pixels, of the new product image.
  • Image – Featured Products Width: The width, in pixels, of the featured product image.
  • Image – Featured Products Height: The height, in pixels, of the featured product image.
  • Image – Product All Listing Width: The width, in pixels, of the all products product image.
  • Image – Product All Listing Height: The height, in pixels, of the all products product image.
  • Product Image – No Image Status: Use automatic No Image when none is added to the product.
  • Product Image – No Image picture: The name of the image in /images/ to use as the No Image picture.
  • Image – Use Proportional Images on Products and Categories: Use proportional images on products and categories. (Force image to keep its original proportions and fit inside display dimensions; width or height will be smaller as required.)

If you need help customizing your zen cart web site, or would like a great custom design, please contact us for a quote.

zen cart plus picaflor azul equals success

Zen Cart Admin Menu Guide – Configuration – Maximum Values

Need a great zen cart template? View all of our instant download zen cart templates here:

Zen Cart Templates

The zen cart admin is packed with functionality. Here is a handy overview of all of the Zen Cart Admin – Configuration – Maximum Values settings.

zen cart admin menu guide

Zen Cart Admin – Configuration – Maximum Values

  • Address Book Entries: Maximum number of Address Book entries a customer is permitted to enter in zen cart.
  • Search Results Per Page: Maximum number of products to list on a Search Result page before showing next page navigation.
  • Prev/Next Navigation Page Links: Maximum number of number links displayed in the next page navigation section.
    This number should be small, but not less than three.
  • Products on Special: Maximum number of products on special to display in the “Specials for this Month” zen cart center box.
  • New Products Module: Maximum number of new products to display in a category in the “New Products” zen cart center box.
  • Upcoming Products: Maximum number of upcoming products to display in the “Upcoming Products” zen cart center box listing.
  • Manufacturers List – Scroll Box Size/Style: Maximum number of manufacturers names to be displayed in the manufacturers sidebox. Setting this to 1 or 0 will display a dropdown list instead of the scrollbox.
  • Manufacturers List – Verify Product Exist: Verify that at least one product exists and is active for the manufacturer name to show in the Manufacturers sidebox.
  • Music Genre List – Scroll Box Size/Style: Number of music genre names to be displayed in the music genre sidebox. Setting this to 1 or 0 will display a dropdown list.
  • Record Company List – Scroll Box Size/Style: Number of record company names to be displayed in the scroll box window. Setting this to 1 or 0 will display a dropdown list.
  • Length of Record Company Name: Maximum length of Record Company Name to display in Record Companies sidebox. Longer names will be truncated.
  • Length of Music Genre Name: Maximum length of Music Genre Name to display in Music Genres sidebox. Longer names will be truncated.
  • Credit Card Owner Name: Minimum required length of the Credit Card Owner Name field when customers are entering payment information.
  • Length of Manufacturers Name: Maximum length of Manufacturers Name to display in the Manufacturers sidebox. Longer names will be truncated with an elipsis (…).
  • New Product Reviews Per Page: Maximum number of product reviews to display on each page before showing next page navigation.
  • Random Product Reviews For Box: Maximum number of random product reviews to rotate in the Reviews sidebox.
  • Random New Products For Box: Maximum number of random new products to display in the New Products sidebox.
  • Random Products On Special For Box: Maximum number of random specials to display in the Specials sidebox.
  • Categories To List Per Row: Maximum number of categories to list per row on the Categories pages.
  • New Products Listing- Number Per Page: Maximum number of product listings per page on the New Products pages before showing next page navigation.
  • Best Sellers For Box: Maximum number of best sellers to display in Best Sellers sidebox.
  • Also Purchased Products: Maximum number of products to display in the “This Customer Also Purchased” center box.
  • Recent Purchases Box- NOTE- box is disabled: Maximum number of products to display in the Recent Purchases sidebox.
  • Customer Order History List Per Page: Maximum number of orders to display in the order history list in My Account.
  • Maximum Display of Customers on Customers Page: Maximum number of customers to display each Customers page in the Admin before showing next page navigation.
  • Maximum Display of Orders on Orders Page: Maximum number of orders to display on each Orders page in the Admin before showing next page navigation.
  • Maximum Display of Products on Reports: Maximum number of products to display per page on reports in the Admin before showing next page navigation.
  • Maximum Categories Products Display List: Maximum number of products to list per page in the Admin before showing next page navigation.
  • Products Attributes – Option Names and Values Display: Maximum number of option names and option values to display on the Products Attributes page in the Admin before showing next page navigation.
  • Products Attributes – Attributes Controller Display: Maximum number of attributes to display on the Attributes Controller page in the Admin before showing next page navigation.
  • Products Attributes – Downloads Manager Display: Maximum number of attributes downloads to display on the Downloads Manager page in the Admin before showing next page navigation.
  • Featured Products – Number to Display Admin: Maximum number of featured products to list per page in the Admin before showing next page navigation.
  • Maximum Display of Featured Products – Main Page: Maximum number of featured products to display on the main page before showing next page navigation.
  • Maximum Display of Featured Products Page: Maximum number of featured products to display per page in the Admin before showing next page navigation.
  • Products Listing- Number Per Page: Maximum number of products to list per page on the main page before showing next page navigation.
  • Random Featured Products For Box: Maximum number of random featured products to display in Featured Products sidebox.
  • Maximum Display of Specials Products – Main Page: Maximum number of special products to list on main page before showing next page navigation.
  • New Product Listing – Limited to …: Limit the New Product Listing to: 0 = All desc, 1 = Current Month, 30 = 30 days, 60 = 60 Days, 90 = 90 Days, 120 = 120 Days
  • Maximum Display of Products All Page: Maximum number of products to list per page on the All Products page before showing next page navigation.
  • Maximum Display of Language Flags in Language Side Box: Maximum number of language flags to display per row in the Languages sidebox.
  • Maximum File Upload Size: Maximum file size for uploads in bytes. This threshold is also dependent on the PHP setting for your server for maximum-upload-size. The lower of the two numbers will be used. Work with your host to change the PHP setting if needed.
  • Allowed Filename Extensions for uploading: The permissible filetypes (filename extensions) to be allowed when files are uploaded to your site by customers. Separate multiple values with commas (,). Do not include the dot (.).
  • Maximum Orders Detail Display on Admin Orders Listing: Maximum number of Order Details in the Admin before showing next page navigation. 0 = Unlimited.
  • Maximum PayPal IPN Display on Admin Listing: Number of records to show on the PayPal™ IPN Listing page in the Admin before showing next page navigation.
  • Maximum Display Columns Products to Multiple Categories Manager: Maximum display columns in the Products to Multiple Categories Manager in the Admin.
  • Maximum Display EZ-Pages: Number of EZ-Pages records to display in the Admin before showing next page navigation.

If you need help customizing your zen cart web site, or would like a great custom zen cart design, please contact the zen cart experts at Picaflor Azul for a quote.

zen cart plus picaflor azul equals success

Zen Cart Admin Menu Guide – Configuration – Minimum Values

Need a great zen cart template? View all of our instant download templates here:

Zen Cart Templates

The zen cart admin is packed with functionality. Here is a handy overview of all of the Admin – Configuration – Minimum Values settings.

zen cart admin guide

Configuration – Minimum Values

  • First Name: Minimum required length of the First Name field.
  • Nick Name: Minimum required length of the Nick Name field. The Nick Name field is used only when connecting the store to a related support forum such as phpBB and becomes their username there.
  • Last Name: Minimum required length of the Last Name field.
  • Date of Birth: Minimum required length of the Date of Birth, if the field is enabled. Set it to 0 to disable the field length checking. Date-format validation is done separately.
  • E-Mail Address: Minimum required length of the Email Address field.
  • Street Address: Minimum required length of the Street Address field.
  • Company: Minimum required length of the Company field.
  • Post Code: Minimum required length the of Post Code field when.
  • City: Minimum required length of the City field.
  • State: Minimum required length of the State field.
  • Telephone Number: Minimum required length of the Telephone Number field
  • Password: Minimum required length of the Password field.
  • Credit Card Owner Name: Minimum required length of the Credit Card Owner Name field when customers are entering payment information.
  • Credit Card Number: Minimum required length of the Credit Card Number field when customers are entering their payment information.
  • Credit Card CVV Number: Minimum required length of the Credit Card CVV Number field when customers are entering their payment information.
  • Product Review Text: Minimum required length of the Product Review Text field.
  • Best Sellers: Minimum number of Best Sellers which must be in the database for the Best Sellers sidebox to show.
  • Also Purchased Products: The minimum number of products to display in the “This Customer Also Purchased” center box.

If you need help customizing your zen cart web site, or would like a great custom design, please contact us for a quote.

zen cart plus picaflor azul equals success