Forums / Addon Shipping Modules / How do I install zen-cart module?

How do I install zen-cart module?

Locked

Started by basialee on 21 Jun 2008, 1:04 AM · Views: 32,567

Results 1 to 17 of 17
This thread is locked. New replies are disabled.
21 Jun 2008, 1:04 AM
#1
basialee avatar

basialee

New Zenner

Join Date:
Jun 2008
Posts:
1
Plugin Contributions:
0

How do I install zen-cart module?

I have searched on this site, but still can't find the instruction.
My zen-cart only have shipping, payment and order default module
if I want to install module,
what should I do?

Should I just upload the whole folder to
includes/modules/
or
/includes/languages/english/modules/

??

What is the correct procedures?

Thank you for your help.

21 Jun 2008, 1:07 AM
#2
charmedbytina2 avatar

charmedbytina2

Totally Zenned

Join Date:
Mar 2007
Location:
AZ
Posts:
1,890
Plugin Contributions:
0

Re: How do I install zen-cart module?

if I want to install module, what should I do?

Follow the installation and read me file directions with the modude you want to install.

Tina

6 Jun 2009, 12:42 PM
#3
recallcreative avatar

recallcreative

New Zenner

Join Date:
May 2009
Posts:
18
Plugin Contributions:
0

Re: How do I install zen-cart module?

I have the same query and the readme is written for people who know what they're doing. I need an absolute idiots guide.

I'm trying to install Events Calendar module. I have followed the instructions in the readme.txt but the module is not appearing in my modules dropdown in admin.

I know this is really simple stuff when you know what you're doing, but when you haven't got a clue, it's really frustrating.

PLEASE PLEASE PLEASE don't reply to this post and tell me to search the forum for an answer! I have. This forum does not seem to cater for complete idiots like me!

6 Jun 2009, 1:30 PM
#4
kuroi avatar

kuroi

Totally Zenned

Join Date:
Apr 2006
Location:
London, UK
Posts:
10,475
Plugin Contributions:
11

Re: How do I install zen-cart module?

This is a forum for people of all abilities, however, it's often difficult for people answering questions to gauge how much the person answering the questions knows. So to avoid every answer becoming patronising for the recipient and tedious for us to write, we tend to assume that people have some basic knowledge of FTP (file transfer protocol), the Zen Cart file structure and know how to edit a file with a text browser and install a SQL patch.

Only one of these actually has anything to do with Zen Cart specifically, the other three are general and easily acquired web skills. However, if one or all of them are new to you, that's fine too. I can still remember when they were a black art for me too, and you'll quickly pick them up.

Do you have an FTP tool (if so which one)? Do you have a text editor (different from a word processor), and if so, which one?

Kuroi Web Design and Development | Twitter

(Questions answered in the forum only - so that any forum member can benefit - not by personal message)

6 Jun 2009, 2:04 PM
#5
recallcreative avatar

recallcreative

New Zenner

Join Date:
May 2009
Posts:
18
Plugin Contributions:
0

Re: How do I install zen-cart module?

Hi Kuroi,

I use cyberduck for my FTP and dreamweaver. I'm alright at basic html stuff, but when it comes to this I am completely dumbfounded. I've got this far but my client wants to add an events calendar. I have tried to install the module, but can't seem to get it to show in my admin.

I also need a complete bafoons guide to adding EZ Pages. As you can see, i have added the links to the header bar, but I've no idea how or where I go to physically make the pages???

Any help would be greatly appreciated. In lamens terms if you don't mind. I'm a designer, not a developer.

Thanks,
Rick

6 Jun 2009, 2:45 PM
#6
kuroi avatar

kuroi

Totally Zenned

Join Date:
Apr 2006
Location:
London, UK
Posts:
10,475
Plugin Contributions:
11

Re: How do I install zen-cart module?

It's worth noting that the events calendar's installation instructions are a bit more terse than most. So I can understand why you'd find them challenging as first attempt. Though it's also worth pointing out that htis was released as a use at your own risk beta. So you may still encounter some problems with it in operation. If you do, the best place to get help will be in the main thread about it, as that's where the people who use it (I'm not one of them) hang out.

But let's get back to installing it. The first place to go is your site's Admin area. Under the tools menu, you'll find an option to "Install SQL Patches". Selecting this will bring up a page which includes an "Upload File" field. Click on the "browse" button next to this field and browse to the oddly-named "tabelenupdate.sql" file where you unpacked the addon's zip archive. Click "Upload" and that's the first step completed.

For the 2nd step, fire up Cyberduck and drag and drop the admin, images and includes folders into the root folder of your site. The root folder is the one at the top level of your site (though not usually the hosting account) which already has these three folders. You may be asked if you want to over-write these folders.The answer should be yes, it won't actually over-write, just add additional files to them.

For step 3, you can probably use Cyberduck. Certainly it claims to be able to change the permissions on file (aka chmoding). However, as I don't use Cyberduck, I can't advise on how (try right clicking on the filename in the server window, or control clicking if you don't have a right click). Sometimes web hosts prevent these remote changes, in which case they should give you an alternative tool in the account's control panel. Some servers don't like 777 or 0777 in whoch case try 755, or ask the advise of the web host.

Step 4 is a little more complex. Use Cyberduck to go to your includes/templates/customtemplate/common folder. If there's a tpl_main_page.php file there, download it to your Mac. Otherwise get a copy from the includes/templates/template_default/common folder. Edit this to make the changes suggested in step 4 of the readme. You can do this with Dreamweaver's code view. Then upload it to the site (drag and drop again), making sure that wherever you got it from, you return your version to the includes/templates/customtemplate/common folder.

You can probably ignore step 5 for the moment. You will only need to do that if you want to change the text that is displayed on the screen by this addon.

You may come across some wrinkles since you are using a custom template that may not have the same structure as a normal Zen Cart, but let's hope not.

If everything goes smoothly, you should find that a new page has appeared under the Admin > Extras menu and a sidebox is ready for enablement under Admin > Tools > Layout Boxes Controller.

Questions about EZ-Pages would need to go in a new thread. Though I would point you first to Admin > Tools > EZ-Pages as I suspect that you may be heading of at a tangent, and then to the FAQ section on EZ-Pages.

Kuroi Web Design and Development | Twitter

(Questions answered in the forum only - so that any forum member can benefit - not by personal message)

6 Jun 2009, 3:15 PM
#7
recallcreative avatar

recallcreative

New Zenner

Join Date:
May 2009
Posts:
18
Plugin Contributions:
0

Re: How do I install zen-cart module?

Kuroi,

That's the most succinct and brilliant reply to any post on this forum! I will go through these steps now.

Thank you so much for explaining in such a clear way.

Rick

6 Jun 2009, 3:29 PM
#8
recallcreative avatar

recallcreative

New Zenner

Join Date:
May 2009
Posts:
18
Plugin Contributions:
0

Re: How do I install zen-cart module?

It was all going too well! I did what you said and it did appear as a sidebox to enable, which I then did, right sidebox- order number 1. and despite furious and frantic refreshing of the site, it has not appeared. BUM!!! :no:

Any suggestions of what I'm doing wrong?

6 Jun 2009, 3:39 PM
#9
kuroi avatar

kuroi

Totally Zenned

Join Date:
Apr 2006
Location:
London, UK
Posts:
10,475
Plugin Contributions:
11

Re: How do I install zen-cart module?

It's probably not something that you did. What's actually happening is that your site is crashing, but not before most of the output has already been sent to the browser. Look carefully and you'll see that it's not just that sidebox, but also the footer that's missing, i.e. everything that should also be displayed after the sidebox.

These sorts of problems are usually due to poor programming or problems with the language files. If you didn't change the language file (step 5 of the installation), then I'd recommend skooting over to the thread that I quoted in my earlier post to see if anybody else has had this problem.

There is an alternative approach using a debug utility, that can track these problems down, but using that is a bit techie, and I'd check whether anybody already has a pithy answer posted in the other thread first.

Kuroi Web Design and Development | Twitter

(Questions answered in the forum only - so that any forum member can benefit - not by personal message)

6 Jun 2009, 4:40 PM
#10
recallcreative avatar

recallcreative

New Zenner

Join Date:
May 2009
Posts:
18
Plugin Contributions:
0

Re: How do I install zen-cart module?

it's a template monster template. i understand that they are the bane of proper zen developers' lives. I wish I'd known before spending 100 quid on it.

basically, I'm stuffed aren't I?

6 Jun 2009, 4:55 PM
#11
kuroi avatar

kuroi

Totally Zenned

Join Date:
Apr 2006
Location:
London, UK
Posts:
10,475
Plugin Contributions:
11

Re: How do I install zen-cart module?

Not at all. Have a go with the debug facility. You'll need to upload it much as you did with the Events Calendar. Refresh your browser and then download and read the log file. That will hopefully tell us where the error is, and once we know that, we can work out how to deal with it.

Kuroi Web Design and Development | Twitter

(Questions answered in the forum only - so that any forum member can benefit - not by personal message)

6 Jun 2009, 5:09 PM
#12
recallcreative avatar

recallcreative

New Zenner

Join Date:
May 2009
Posts:
18
Plugin Contributions:
0

Re: How do I install zen-cart module?

ok, here's what I got:

[06-Jun-2009 18:06:30] PHP Warning: require(includes/templates/template_default/sideboxes/tpl_calendar_sidebox.php) [<a href='function.require'>function.require</a>]: failed to open stream: No such file or directory in /home/fhlinux134/a/andreamilescrystals.co.uk/user/htdocs/test/includes/modules/sideboxes/calendar.php on line 22
[06-Jun-2009 18:06:30] PHP Warning: require(includes/templates/template_default/sideboxes/tpl_calendar_sidebox.php) [<a href='function.require'>function.require</a>]: failed to open stream: No such file or directory in /home/fhlinux134/a/andreamilescrystals.co.uk/user/htdocs/test/includes/modules/sideboxes/calendar.php on line 22
[06-Jun-2009 18:06:30] PHP Fatal error: require() [<a href='function.require'>function.require</a>]: Failed opening required 'includes/templates/template_default/sideboxes/tpl_calendar_sidebox.php' (include_path='.:/usr/share/pear-php5') in /home/fhlinux134/a/andreamilescrystals.co.uk/user/htdocs/test/includes/modules/sideboxes/calendar.php on line 22

Quite frankly, that's gobbledygook to me.

6 Jun 2009, 5:18 PM
#13
kuroi avatar

kuroi

Totally Zenned

Join Date:
Apr 2006
Location:
London, UK
Posts:
10,475
Plugin Contributions:
11

Re: How do I install zen-cart module?

What that tells us is that there is a step missing in the installation instructions. There's a folder called includes/templates/YOUR_TEMPLATE with three sub folders inside. That folder should have been renamed (in your case) includes/templates/customtemplate before being uploaded.

No problem though. You can use CyberDuck to drag the subfolders from includes/templates/YOUR_TEMPLATE to includes/templates/customtemplate. Again, no worried about over-writing. Then delete includes/templates/YOUR_TEMPLATE (show it who's boss).

Kuroi Web Design and Development | Twitter

(Questions answered in the forum only - so that any forum member can benefit - not by personal message)

6 Jun 2009, 7:34 PM
#14
recallcreative avatar

recallcreative

New Zenner

Join Date:
May 2009
Posts:
18
Plugin Contributions:
0

Re: How do I install zen-cart module?

YEEEEEEAAAAAAAHHHHHHH!!!!!!!

You're the boss! Thank you so much! You've been well helpful today.

I'm sure I'll need you're help again, but for now you've been a saviour and a gentleman/woman. Thanks again.

Rick :clap: :clap: :clap:

7 Jun 2009, 7:47 AM
#15
recallcreative avatar

recallcreative

New Zenner

Join Date:
May 2009
Posts:
18
Plugin Contributions:
0

Re: How do I install zen-cart module?

Back again!

Now when I click on an event in my calendar side box, it takes me to the events_calendar page, which is great, but there is just a title bar saying events calendar and nothing else. I get this error when I do that debug thingy:

[07-Jun-2009 08:06:42] PHP Parse error: syntax error, unexpected '}' in /home/fhlinux134/a/andreamilescrystals.co.uk/user/htdocs/test/includes/modules/events_calendar_listing.php on line 23

<?php

/** --------------------------------------------------------------------- */
/** zen-cart Open Source E-commerce                                       */
/** --------------------------------------------------------------------- */
/**  Copyright (c) 2003 The zen-cart developers     */
/**                                                                 */
/**  http://www.zen-cart.com/index.php           */
/**                                                                   */
/** Portions Copyright (c) 2003 osCommerce                               */
/** ----------------------------------------------------------------------   */
/** This source file is subject to version 2.0 of the GPL license,       */
/**  that is bundled with this package in the file LICENSE, and is       */
/** available through the world-wide-web at the following url:           */
/**  http://www.zen-cart.com/license/2_0.txt.                             */
/**  If you did not receive a copy of the zen-cart license and are unable */
/** to obtain it through the world-wide-web, please send a note to       */
/** [email protected] so we can mail you a copy immediately.          */
/** ----------------------------------------------------------------------  */
/** $Id: events_manager.php 2007-07-10 [email protected]  */


if(isset($listingTitle)){    echo '<H2>' . $listingTitle . '</H2>';}$events_split = new splitPageResults($events_query_raw, MAX_DISPLAY_NUMBER_EVENTS, 'DAYOFMONTH(start_date)');$events_query = $db->Execute($events_query_raw);//Show Paging Header ?if (($events_split->number_of_rows > 0) && ((PREV_NEXT_BAR_LOCATION == '1') || (PREV_NEXT_BAR_LOCATION == '3'))) {?>        </td>    </tr>    <tr>        <td>            <table border="0" width="100%" cellspacing="0" cellpadding="2">                <tr>                    <td class="smallText">                        <?php                             if(isset($displayPagingSuffix))                            {                                $displayPagingSuffix = ' : ' . $displayPagingSuffix;                            }                            echo $events_split->display_count(TEXT_DISPLAY_NUMBER_OF_PAGES . $displayPagingSuffix);                         ?>                    </td>                    <td align="right" class="smallText">                        <?php echo TEXT_RESULT_PAGE . ' ' . $events_split->display_links(MAX_DISPLAY_PAGE_LINKS, zen_get_all_get_params(array('page', 'info', 'x', 'y'))); ?>                    </td>                </tr>            </table>        </td>    </tr>    <tr>        <td><?php} $row = 0;$list_box_contents = array();//Add headings ...$list_box_contents[$row][] = array('align' => 'left',                                'params' => 'class="event_header"',                                'text' => ' Start ' . TEXT_EVENT_DATE . ' ');$list_box_contents[$row][] = array('align' => 'left',                                'params' => 'class="event_header"',                                'text' => ' End ' . TEXT_EVENT_DATE . ' ');$list_box_contents[$row][] = array('align' => 'center',                                'params' => 'class="event_header"',                                'text' => ' ' . TEXT_EVENT_TITLE . ' ');//Add listing rows ...    $events = $db->Execute($events_split->sql_query);
//while($events = zen_db_fetch_array($events_query))
while (!$events->EOF){    $row++;    list($year, $month, $day) = split ('[/.-]', $events->fields['start_date']);            $list_box_contents[$row][] = array('align'  => 'left',                                       'params' => 'class="event_description"',                                       'text'   => date("F j, Y", mktime(0, 0, 0, $month, $day, $year)));    $endDate = '-';    if(isset($events->fields['end_date']) && trim($events->fields['end_date']) != '')    {        list($year, $month, $day) = split ('[/.-]', $events->fields['end_date']);        $endDate = date("F j, Y", mktime(0, 0, 0, $month, $day, $year));    }    $list_box_contents[$row][] = array('align'  => 'left',                                       'params' => 'class="event_description"',                                       'text'   => $endDate);    $list_box_contents[$row][] = array('align' => 'left',                                       'params' => 'class="event_description"',                                       'text'  =>  '<a href="index.php?main_page='                                           . FILENAME_EVENTS_CALENDAR . '&select_event=' . $events->fields['event_id'] . '">'                                           . $events->fields['title'] . '</a>');
   $events->MoveNext();                                       }//Show listing 
  require($template->get_template_dir('tpl_tabular_display.php',DIR_WS_TEMPLATE, $current_page_base,'common'). '/tpl_tabular_display.php');//new productListingBox($list_box_contents);    if (($events_split->number_of_rows > 0) && ((PREV_NEXT_BAR_LOCATION == '2') || (PREV_NEXT_BAR_LOCATION == '3'))) {?>        </td>    </tr>    <tr>        <td>            <table border="0" width="100%" cellspacing="0" cellpadding="2">                <tr>                    <td class="smallText">                        <?php                             if(isset($displayPagingSuffix))                            {                                $displayPagingSuffix = ' : ' . $displayPagingSuffix;                            }                            echo $events_split->display_count(TEXT_DISPLAY_NUMBER_OF_PAGES . $displayPagingSuffix);                         ?>                    </td>                    <td align="right" class="smallText">                        <?php echo TEXT_RESULT_PAGE . ' ' . $events_split->display_links(MAX_DISPLAY_PAGE_LINKS, zen_get_all_get_params(array('page', 'info', 'x', 'y'))); ?>                    </td>                </tr>            </table>        </td>    </tr>    <tr>        <td><?php}else{?>            <table border=0 width="100%" cellspacing="0" cellpadding="4">                <tr>                    <td class="main"><br><?php echo TEXT_NO_EVENTS; ?></td>                </tr>            </table><?php}

?>

I think I see a problem, but I've no idea how to fix it and I only saw it because dreamweaver kindly changes the colours of the code. There's a bit that says "<?php}else{?>" usually, that would be in red, but it's not. Is that the issue or am I barking up the wrong tree?

Sorry for being such a dufus.

7 Jun 2009, 7:55 AM
#16
recallcreative avatar

recallcreative

New Zenner

Join Date:
May 2009
Posts:
18
Plugin Contributions:
0

Re: How do I install zen-cart module?

scratch last post.

I think I was just being super thick! I added an event on a date in the past!!!!!

It works fine.

7 Jun 2009, 9:06 AM
#17
kuroi avatar

kuroi

Totally Zenned

Join Date:
Apr 2006
Location:
London, UK
Posts:
10,475
Plugin Contributions:
11

Re: How do I install zen-cart module?

Glad to hear you got it sorted, and congrats on getting to grips with the debug facility so quickly. It sounds like you came up that learning curve for basic skills very quickly.

A reminder that questions about how the addon itself functions should be posted in its dedicated thread.

I'm suspecting that you may have need of that thread as the quality of the programming leaves a little to be desired. From what you posted I can see tags that won't validate (xhtml, the browse language output by Zen Cart requires lowercase tags, not uppercase like "H2") and well-written code would be able to handle dates outside its valid range in a manner more elegant than crashing PHP. So you may have a bumpy ride ahead, but if it's doing broadly what its supposed to, then that's most of the battle won.

Kuroi Web Design and Development | Twitter

(Questions answered in the forum only - so that any forum member can benefit - not by personal message)