Auteur Topic: Oscommerce installatie handleiding  (gelezen 9724 keer)

Domein-Direct

  • Forumbeheerder
  • Senior
  • *****
  • Berichten: 270
  • Karma: 0
    • E-mail
Oscommerce installatie handleiding
« Gepost op: 28 maart 2010, 16:22:36 »
Met dank aan de Nederlandse afdeling van oscommerce.

SOFTWARE:
Type....: online webshopsoftware
Source..: Open Source
URL.....: http://www.oscommerce.com/
http://www.oscommerce.com/redirect.php/go,44


NL-taalfiles: 2.2 MS2 051113 Dutch Language Pack * NL_taalpakket
- : http://www.oscommerce.com/community/contributions,4065
- : http://www.oscommerce.com/community/contri.../download,12961


INSTALLATIE:
Online webshops worden normalerwijze geïnstalleerd op een "webserver" bij een hoster zoals domein-direct.

HARD- en SOFTWARE:
Om makkelijk met osCommerce te kunnen werken is minimum een Apachewebserver met PHP (PHP versie 4.3> is O.K.) en een MySQL Database-server nodig, zie de links onderaan de pagina.


Meestal staan er bij de (website)hoster (en local) nog (vele) andere noodzakelijke extra's ter beschikkig zoals phpMyAdmin enz., die faciliteiten worden min of meer als vanzelfsprekend verondersteld.

Een gewoon goed (gratis) FTP-programma is ook nodig.
Zie ook bij punt 1.

Een osCommerce-webshop bestaat principieel uit twee gedeeltes: het /(catalog)/-gedeelte en het /admin/-gedeelte.
Het /admin/-gedeelte is in de standaard install een onderdeel (subdir) van /(catalog)/.

Het catalog-gedeelte, de buitenkant van de shop, wordt standaard geïnstalleerd in de map: /(catalog)/, waardoor de shop een onderdeel kan vormen van een al bestaande website.

Indien de installatieprocedure wordt aangepast kunnen de mappen + bestanden die in /(catalog)/ staan ook direct in de "root" (../*.*) geplaatst worden.
Bij het starten van de website wordt dan direct d.m.v de kortst mogelijke URL <http://www.jouw-shop.nl>
de shop geladen, i.p.v een IMO totaal overbodige z.g. "startpagina" waardoor de URL er bijv. zo uit gaat zien <http://www.jouw-shop.nl/(catalog)/>.

Opm.:
Onderstaande gaat uit van het -verplaatsen- van de map /(catalog)/ naar je website, indien de mappen en bestanden "uit" de map /(catalog)/ worden -verplaatst- hou er dan rekening mee dat in dat geval (catalog) tussen haakjes staat.

Het administratiegedeelte wordt standaard in de map /(catalog)/admin/ geplaatst, maar kan (door een meer ervaren website-inrichter) om bepaalde redenen ook in een andere locatie geplaatst worden.


DOWNLOAD:
0.
- Download het bestand :http://www.oscommerce.com/redirect.php/go,44
- <http://www.oscommerce.com/solutions/downloads/>
- Unzip het bestand: naar de map: /temp/ of: /tmp/,
of ieder andere map waar je tijdelijke bestanden plaatst.


- Lees minstens de tekstfiles door (faq, install, readme, enz.)
- Advies: bewaar een back-up copy van oscommerce [altijd handig, geloof me :-)]


INSTALLATIE:
1.
HOST_PANEL:
- maak een MySQL database aan of vraag aan je hoster om dat te doen.
- - noteer de naam van je: db
- - noteer de naam van je: user_name
- - noteer het password van je: user_password.

WEBSERVER
FTP => bestanden verplaatsen van je PC naar je server:
- HTML-, JAVASCRIPT-, PERL(scripts)-, CSS-, PHP-bestanden met .cgi of .pl extensions zijn TEXT-files => dus upload in ASCII(7bit) of AUTO.
- GIF, JPG, (WORD-files), gecompileerde scripts zijn BINAIR => dus upload in Binary(8bit).
- Upload van alle bestanden in Binary(8bit) is meestal O.K.
- Alles uploaden in ASCII levert meestal gegarandeerd moeilijkheden op.
- Met sommige FTP-progs kun je makkelijker werken dan met andere.

- Upload een copy van de map /(catalog)/ of de inhoud van de map /(catalog)/ naar de root van je webruimte.
- - Resultaat: ../root/(catalog)/*.*, vaak is dat ../web/(catalog)/*.*
- - voorbeeld: <http://www.jouw-domain.tld/(catalog)/>
- - of zet de mappen EN bestanden uit /(catalog)/ meteen in de root: ../web/*.*


2.
WEBSERVER
- Ga nu eerst met je FTP prog naar de bestanden en zet de (pre-install)rechten:
- - 755(777) (catalog)/admin/includes
- - 706(777) (catalog)/admin/includes/configure.php
- - 706(777) (catalog)/images
- - 755(777) (catalog)/includes
- - 706(777) (catalog)/includes/configure.php
Lukt het niet met 755 en 706, gebruik dan 777, 777 = writable during installation

3.
Maak de database en de gebruiker aan en/of controleer de gegevens.
Opm.: tijdens de installatie stelt oscommerce als database-naam voor: oscommerce.
Het kan zijn dat de hoster een (andere) naam voorschrijft.



4.2
WEBSERVER
- Tik in het browservenster: <http://www.jouwdomain.tld/(catalog)/install/> en mep op de entertoets.
- De installatie begint, er verschijnen configuratieschermen.

SCHERMEN:
5.
Schermnaam:
- New Installation
- Please customize the new installetion with the following options
- Import Catalog Database
- vinkje (laat staan)
- Automatic Configuration
- vinkje (laat staan)

Schermnaam:
- New Installation
- Database Import
- Please enter the database server information
- Databaseserver
- als onbekend met wat er moet staan probeer:localhost of: 127.0.0.1
- Username
- usernaam > indien "local" kan dat ook leeg blijven
- Password
- password > indien "local" kan dat ook leeg blijven
- Database Name
- oscommerce (of eventueel iets anders, of zie gegevens provider)
- Persistent Connections
- klik op het vraagteken, vraag provider, meestal "geen" vinkje
- Session Storage
- is meestal Database

Schermnaam:
- New installation
- Database Import
- A test connection made to the database was successful!
- Klik op continue, wacht en doe NIETS totdat het volgende scherm verschijnt.

Schermnaam:
- New Installation
- Database Import
- The Database import was successful!

Schermnaam:
- New installation
- osCommerce configuration
- Please enter the webserver information
- (vraag nu eventueel je provider voor de data die je hier moet invullen)
- WWW Address
- Webserver Root Directory
- verschijnt vaak automagisch
- HTTP Cookie Domain
- verschijnt vaak automagisch
- HTTP Cookie Path
- /(catalog)/
- Enable SSL Connection
- vinkje (of niet)

Scherm:
- New installation => verschijnt niet indien SSL niet aangevinkt is.
- osCommerce configuration
- Please enter the secure web server information
- Secure WWW address
- begint met httpS://
- Secure Cookie Domain
- domein
- Secure Cookie Path
- /(catalog)/

Scherm:
- New installation
- osCommerce configuration
- Klik op continue om te gegevens te bevestigen

Scherm:
- New installation
- osCommerce configuration
- The configuration was successful!
- Klik op Catalog
- de catalog opent in een nieuw scherm
- Klik op Administration Tool
- admin opent ook in een nieuw scherm

Scherm:
- er is iets niet in orde, je ziet bijv. deze melding verschijnen:

<quote>
The following error has occurred:

The configuration files do not exist, or permission levels are not set.

Please perform the following actions:
cd /***/***/***/***/***/****/includes/
touch configure.php
chmod 706 configure.php
cd /***/***/***/***/***/***/admin/includes/
touch configure.php
chmod 706 configure.php

If chmod 706 does not work, please try chmod 777.

If you are running this installation procedure under a Microsoft Windows environment, try renaming the existing configuration file so a new file can be created.
</quote>


- In dat geval is INSTALLATIE; stap 2. (goed) fout gegaan :-(
- Laat in dat geval dat scherm staan, start FTP op en verbeter de fouten als volgt:
- ga in FTP naar het bestand catalog/configure.php en CHMOD het bestand naar 706
- ga daarna naar het bestand /(catalog)/admin/includes/configure.php en CHMOD het bestand naar 706
- ga terug naar het "fout" scherm in je browser en ga verder met het proces.


VEILIGHEID:
6.1
Gebruik je Account Control Panel en beveilig de map /admin/.
of
6.2
Gebruik .htaccess om de map /admin/ te beveiligen
of
6.3
FTP naar je server
Verwijder de map: /install/ of geef 'm in ieder geval een "moeilijke" naam, of verplaats 'm naar ergens anders buiten de map /(catalog)/.


ERROR MELDINGEN
7.1
Check
- controleer of de mappen in 7.2 bestaan.

7.2
Rechten (CHMOD), check, verander, maak en/of controleer de (post-install)rechten:
777-------------/(catalog)/admin/backups
777-------------/(catalog)/admin/images => de dir
777-------------/(catalog)/admin/images/graphs => ook andere subdirs!
777-------------/(catalog)/admin/images/graphs/banner_daily-1.png => alle files
777-------------/(catalog)/admin/images/graphs/banner_infobox-1.png => alle files
755-------------/(catalog)/admin/includes
644(444)--------/(catalog)/admin/includes/configure.php
644(444)--------/(catalog)/admin/includes/local/configure.bak
777-------------/(catalog)/admin/tmp
777-------------/(catalog)/cache => t.b.v cache (+ absolute path ervoor)
755-------------/(catalog)/download
777-------------/(catalog)/images
777-------------/(catalog)/images_large
777-------------/(catalog)/images_medium
777-------------/(catalog)/images/subdir
777-------------/(catalog)/images_*/*.gif, *.jpg, enz
755-------------/(catalog)/includes
644(444)--------/(catalog)/includes/configure.php
644(444)--------/(catalog)/includes/local/configure.bak
777-------------/(catalog)/pub
777-------------/(catalog)/temp => t.b.v Easy Populate
777-------------/(catalog)/tmp
777-------------/(catalog)/tmp/page_parse_time.log => evt. eerst zelf de file maken

NB_1:
Zorg voor afdoende beveiliging op de server van alle dir's






ADMIN:
8.
Beveilig de map:
- /admin// (../(catalog)/admin/*.*)
Vaak kan dat op de website d.m.v je PLESK websiteadministratieprogramma (scrabble: woordwaarde!).
Of gebruik:
- .htaccess <http://www.oscommerce.nl/htaccess_generator.php>
Of download:
- phpaccess103.zip [2003-04-12] op <http://www.krizleebear.de/phpaccess/dynamisch/>
Lukt dat ook niet:
- hernoem /admin/ naar een "moeilijke" naam.
- Die "moeilijke" naam moet dan wel elke keer gewijzigd worden indien in /admin/ iets moet worden aangepast.
- of je kunt in de 2 stuks configure.php de nodige wijzigingen aanbrengen.

TAALPAKETTEN => NL
9.
2.2 MS2 051113 Dutch Language Pack * NL_taalpakket
NL_Taalpakket_v1.4.4 berkedam 16 Apr 2006
http://www.oscommerce.com/community/contributions,4065
http://www.oscommerce.com/community/contri.../download,12961

Pak de zip uit en copy met FTP de bestanden over je bestaande. Klaar

LET OP:
DOOR VERSCHILLENDE OORZAKEN RAKEN VEEL SHOPOWNERS SOMS EEN DEEL VAN HUN GEGEVENS KWIJT.
DAT KAN VEELAL VOORKOMEN WORDEN DOOR DE ENGELSE TAAL NIET TE DELETEN!
ENGELS DEACTIVEREN, IN DE /ADMINISTRATIE/ => CATALOG-SIDE GEEN VLAGGETJE, KAN GEEN KWAAD.

JE KUNT DAN LATER INDIEN NODIG DAN VAAK MAKKELIJKER WEER IN JE ADMIN KOMEN.


BACK-UP
10.
Check of er in /(catalog)/ of /admin/ fouten zijn indien niet:
- Maak dan nu een eerste back-up van al de shopbestanden en de db nu er nog niets veranderd is, altijd handig :-)


WIJZIGEN VAN DE SHOP
11.
Start 2 browservensters op, of 2 tabs:
Klik in het blauwe scherm op CONFIGURATION en begin eerst met het bijwerken van de shopdata.
Switch met Alt+Tab tussen de browservensters.
Doe Shift+Reload en bekijk het catalog resultaat.

11.1
Start "local" je favoriete goede teksteditor, liever niet Wordpad of Notepad.
- open ../(catalog)/includes/languages/dutch/index.php in die editor en begin met het veranderen


Opm.:
Het is géén goed idee om met behulp van de "files manager" je files te veranderen.
- de "files manager" in het "administratie" gedeelte, is een geïntegreerde add-on (maar geen osCommerce ontwikkeling) waar bepaalde bugs nog niet uitgehaald zijn.
Het is ook géén goed idee om je files "online" te veranderen, want als je shop opeens niet meer werkt dan ...

11.2
PHP files bestaan uit:
- HTML-code, CSS-code, JS-code en natuurlijk veel PHP-code.
- de meeste veranderingen aan de shop kunnen doorgevoerd worden indien de nodige kennis hebt van HTML en CSS aanwezig is, is dat niet het geval dan zal die kennis echt bijgespijkerd moeten worden.
- Bedenk dat je met de bron-code van software bezig bent dus vóórdat je iets gaat veranderen:
- back-up, back-up, back-up, back-up, back-up, back-up, back-up, back-up, back-up, back-up


HULPBRONNEN
12.
<http://www.oscommerce.nl/>
<http://www.oscommerce.nl/forums/index.php?act=Search&f=>
<http://forums.oscommerce.nl/forums/>
<http://www.oscommerce.com/>
<http://www.oscommerce.com/community/contributions/>
<http://www.oscommerce.info/kb/16>
<http://www.google.nl/>


OVER CONTRIBUTIES:
- "moet" de contribution?
- heeft die contribution een redundante functie?
- zo ja verwijder dan de andere functie (verminder optreden mogelijke verwarring bij je bezoeker).
- met andere woorden is het "nuttig" voor de bezoeker en de omzet (winst)?
- of vind de webshop_eigenaar c.q. -ontwerper het alleen gewoon ontzettend "cool"?
- denken bezoekers er ook zo over? Ja: doen. => Nee: niet doen!
- is de contributie compatibel met osCommerce 2.2-MS2 versie (07/12/2003)?
- is de contributie besproken in een forum, zijn er bekende makken?

- back-up, back-up, back-up, back-up, back-up, back-up, back-up, back-up

- elke onnodige contribution in de shop vertraagt het bestelproces omdat de browser (veel) meer tijd nodig heeft om de pagina's op te bouwen.
- elke onnodige regel sourcecode in de shop vertraagt het bestelproces.
- verwijder talen en valuta die je niet gebruikt (hoewel ik als back-up altijd EN laat staan).
- log nauwkeurig je veranderingen!


HTML + CSS
handleiding:
- <http://www.handleidinghtml.nl/index.html>


Verbeteringen zijn van harte welkom.

[edit] missende / gezet tussen includes en languages bij punt 9.

Succes

Webmaster Domein Direct
« Laatst bewerkt op: 29 april 2014, 00:48:37 door Domein-Direct »