Convertion template osCSS 1 vers osCSS 2

Ayatus, cynic, j4k, Louis_Cypher, oscim — 2010-11-18T13:46:18Z

Nous allons voir ici, comment transformer un template d'osCSS 1.xx vers le moteur de l'osCSS 2.xx

Le template exemple que nous allons utiliser est le template clean.

Généralités

Pour commencer, il faut comprendre que l'ensemble des fichiers appelés via des include ou require dans le template, n'est plus la méthode préconisée.

En effet, afin de séparer le traitement exécution du code, et celui de l'affichage, les boxes et modules ont été revu.

Il est maintenant nécessaire d'initialiser les boxes et modules, dans un premier temps, et ensuite de les appeler dans le template.

Petite note importante. Recuperer dans le template eletronix, fournis avec le moteur , les fichiers suivant , et ajouter les a dans voter repertoire de template

boxes.php
modules.php

Séparation des contenus

Pour commencer nous allons séparer les contenus, entre les appels generic, commun a toutes les pages (header et footer) ; et le corps de page.

Nous répartirons les contenus dans 3 fichier distinct,

header.php,
template.php
footer.php

Le contenu du fichier header.php, comprend la déclaration html, et le bloc head. De plus, cette entête contient les bloc de retour d'erreur et de prise en charge des title, tag, plugins, javascripts et autres.

echo HTML_PARAMS; ?> >

echo CHARSET; ?>" />

<?php echo $page->the_title(); ?>
echo $the_desc ?>" />
echo $the_key_words ?>" />
echo HEAD_REPLY_TAG_ALL ?>" />

echo (($this->page['var']['request_type']== 'SSL') ? HTTPS_SERVER : HTTP_SERVER) . DIR_WS_CATALOG; ?>" />
echo 'templates/'.$template.'/'; ?>stylesheet.css" media="all"/>

$this->draw_file_header(); ?>

echo HTTP_SERVER.DIR_WS_HTTP_CATALOG.'rss.php' ?>" />
echo CanonicalUrl(); ?>" />

echo page::oscss_body_id() ; ?>" class=" echo 'Type_'.$page->the_type(); ?>">
/** Retour d'erreur checkup sur la boutique */ $this->messageStack->_draw('header'); ?>

Télécharger

D'autre part, nous allons reporter dans le fichier footer les éléments de fin de page

/** Retour d'erreur sur la boutique */ $this->messageStack->_draw('error'); ?>
/** Fichier appel bottom page*/ $this->draw_file_footer(); ?>

Télécharger

Enfin, le reste du contenu sera attribué au fichier template.php

echo $page->tep_get_header() ; ?>

osCSS Demo shop

require_once(DIR_WS_BOXES.'menu.php'); ?>

require_once('includes/content/' . $page_content); ?>

echo $page->tep_get_footer() ; ?>

Télécharger

Dans cet exemple, nous avons remplacer bloc header et footer, par les appels correspondant, à savoir :

Appel du fichier header.php

echo $page->tep_get_header() ; ?>

Appel du fichier footer.php

echo $page->tep_get_footer() ; ?>

Initialisation des boxes et modules

Pour initialiser les élément présent et actif dans le template, nous avons recours au fichier init.php du template. Celui ci est appelé avant le template, pour traiter et calculer l'affichage.

Les boxes

si vous utilisez par ex, la boite languages, appelée comme suit :

include(DIR_WS_BOXES.'languages.php'); ?><

Son initialisation ce fera comme suit :

$this->oscss_boxes->_add('languages', 'hidden');

Tous les chargement de boite ont lieux avec l'appel suivant :

$this->oscss_boxes->_add('nom de la boxes', 'pile');

Avec pour argument :

Le nom de la boite, sans le ".php", cad languages.php devient languages
Le nom de la "pile" dans laquelle on charge la boite. Cette pile est obligatoire , mais vous pouvez ne pas l'utiliser. Dans ce cas, utiliser la pile "hidden" Dans d'autre circonstance, vous pouvez dans le template appeler les boxes, par leur nom, ou sous forme de boucle, avec la pile à laquelle elles appartiennent.

-* Dans notre exemple , template clean

Dans notre exemple, nous allons donc transformer les appels de toutes les boites, et les reporté dans le fichier init.php

...

require_once(DIR_WS_BOXES.'menu.php'); ?>

....

...

Télécharger

Nous pouvons distinguer 2 espace de boite, l'une qui ne contient que menu , et qui s'affiche en haut de page, et l'autre , qui construit la pile du menu de droite .

Aussi, nous allons utiliser 2 pile pour les boites, celle du menu que nous appellerons 'haut", et celle de droite que nous appellerons "droite"

Donnera dans le fichier init

/** Pile haut */
$this->oscss_boxes->_add('menu', 'haut');
/** Pile droite */
$this->oscss_boxes->_add('languages', 'droite');
$this->oscss_boxes->_add('login_box', 'droite');
$this->oscss_boxes->_add('categories', 'droite');
$this->oscss_boxes->_add('search', 'droite');
$this->oscss_boxes->_add('shopping_cart', 'droite');
$this->oscss_boxes->_add('information', 'droite');

Télécharger

-* Les modules

Les modules chargée par cette méthode sont les modules non typé, cad ceux contenu à la racine du dossier module ; Ces module sur la V1, était appelé directement par les page content, désormais, elle sont appelé par le template. Il est ainsi possible de choisir quel module sera présent sur quelle page.

La encore il est nécessaire d'initialiser le module

Pour charger le module new produts, ca donne ca :

$this->oscss_modules->_add(FILENAME_NEW_PRODUCTS,'center',array('sort'=>60));

Nous avons la même logique que pour les boxe, un nom de module, suivi de la pile auquel il appartient .

Fichier de template, appels

Dans notre fichier de template, nous allons pouvoir utiliser tous les elements déjà initialisé. aussi le template ne prend en charge scrupuleusement que l'affichage.

-* Les boxes

Nous allons donc remplacer dans notre fichier template.php , les appels des boites et modules, par leur nouvelle forme

Pour commencer, nous allons appelé la boite menu, de la pile haut. compte tenu que la pile "haut" ne contient qu'une boite, nous pouvons appelé directement la boite dont nous avons besoin par son nom .

$boxe =$page->oscss_boxes->_return('menu'); ?>

include('boxe.php'); ?>

Télécharger

L'appel ce décompose en 2 lignes, la premiere appel la boite precise que nous voulons, cad

$boxe =$page->oscss_boxes->_return('menu'); ?>

La deuxième, fournis le modèle html des boites et affiche le contenu de la boite

include('boxe.php'); ?>

D'autre part, nous voulons aussi affiché la colonne de droite qui est composé de plusieurs boites. Dans ce cas, la methode la plus simple, consiste a appelé la "pile" droite, et ainsi faire une boucle . Nous ecrirons donc l'appel sous cette forme :

while($boxe=templ_draw_list('type=boxes&pile=droite')): ?>

echo $boxe->name_clean; ?>Box" >
include('boxe.php'); ?>

endwhile; ?>

Télécharger

Le code ce decompose comme suit :

Une boucle while, pour lister toutes les boites, avec l'appel à la function templ_draw_list
L'ajout d'un div, contenant un id composé du nom de la boite et du mot Box, soit languagesBox par ex.
De l'appel au template boxe.php d'affichage de la boite.

-* Les modules

Pour appelé les module non typé, utiliser la methode comme suit :

while($themodule=templ_draw_list()): /** Appel des module (new_products, product_listing ...) */ ?>

echo $themodule->id ?>" class=" echo $themodule->css_class; ?> ">
include('module.php'); ?>

endwhile; ?>

Télécharger

Nous utilisons une boucle pour charger tous les module de type center. Lors de l'uage de cette function, le type par defaut est module, et la pile par defaut et center. Aussi dans l'appel ci dessus, il n'est pas necessaire de preciser

On peut aussi ecrire :

templ_draw_list('type=modules&pile=center')

dans notre appel de boucle, on fait appel au fichier de modéle module. tous les modules non type seront prise en charge par ce gabarit de template.

-* Le contenu de page Dans ce moteur , le contenu de page et toujours pris en charge par les fichier contenu dans le répertoire includes/content. Par contre les modules associé a ces page est applé directement par le template.

Le contenu de page : Il etait précément appelé par :

require_once('includes/content/' . $page_content); ?>

La Forme a changé est s'ecrit :

require_once($page->oscss_content()); ?>

Télécharger

Si vous souhaitez utilisé la partie CMS d'osCSS, par exemple pour les infirmation, ou autre, l'appel suivant vous permet de donner la priorité a un article de type cms, plutot qu'a la page contenu dans /content/

/** Page cms de contenu (Page_home, .. ), ou page contenu dans content */
if((($conti=tep_get_cms_content($page->oscss_body_id(), true)) !=false ) && ( $page->oscss_body_id()!='Page_contact_us' ) ) echo $conti;
else require_once($page->oscss_content()); ?>

Télécharger

Howto Installation

Ayatus, j4k, oscim — 2010-09-09T19:37:10Z

Tuto pour mettre en œuvre votre moteur de boutique en ligne.

Pre-requis technique

php > 5.1
mysql > 5
javascript actif
cookie autorisé
Fortement conseillé le mod_rewrite actif sur le serveur

Avec la netinstall

Lorsque vous utilisez la netinstall, vous n'avez pas besoins de régler les droit sur les fichier est dossier, aussi l'installation en sera plus simple et beaucoup plus rapide.

Télécharger la netinstall
pointez avec votre navigateur, http://monurl/netinstall.php
Suivez la procédure

Note : les droits sur les fichiers et répertoire, seront hérités du répertoire parent, aussi, régler les droit du dossier dans lequel vous installez le fichier de la netinstall

Sans la netinstall

Lors d'une install semi manuel, vous devez télécharger le paquet, et le dezziper dans le répertoire de votre domaine.

Recuperer le paquet et extraire celui ci votre le domaine
pointez ensuite avec votre navigateur sur le dossier dans lesquel vous avez installé oscss
Regler les droits sur les dossiers et fichiers comme suit :
1. catalog/ >> ecrtiture
  1. Acces ecriture .htaccess
2. catalog/includes/ >> ecriture
  1. Acces ecriture configure.php
  2. Acces ecriture tables_files_modules.php
3. catalog/oscs_data/ >> ecriture
4. catalog/session/ >> ecriture (normalement creer automatiquement)
5. catalog/pub/ >> ecriture
6. catalog/images/ >> ecriture

1. catalog/admin/images/ >> ecriture
2. catalog/admin/images/ graphs >> ecriture
3. catalog/admin/session/ >> ecriture (normalement creer automatiquement)
4. catalog/admin/backup/ >> ecriture
5. catalog/admin/includes/tmp/ >> ecriture

Utilisation de l'installateur d'extension

Pour permettre un fonctionnement correct du gestionnaire d'extensions, il est nécessaire que le serveur est des droit correct sur l'ensemble du moteur.

Dans le cas de l'utilisation restreinte à l'ajout de module simple, paiement, livraison , dans ce cas, seul les répertoires suivant sont nécessaire

/includes/modules/
/includes/languages/

Dans le front, comme dans le back

Finalisation de l'installation de votre boutique

Pour finaliser l'installation de la boutique, il est nécessaire d'effectuer quelque opération de base.

étape dans l'admin de la boutique

Configuration automatique du template public. Aller dans configuration > apparence > template , survoler le thème actif, et cliquer sur le bouton configuration
Regler les droits sur les fichier sensible, et ensuite desactiver le checkup du systeme Aller dans configuration > backoffice>general ; et placer sur off le checkup systeme , puis sauver
Regler les informations de base de votre boutique, pays , email , etc.. Aller dans configuration > configuration >ma boutique

étape dans les fichiers configure.php

Restructuration du dépôt Subversion de SourceForge

Ayatus, oscim — 2010-08-23T10:08:46Z

Une réorganisation importante du dépôt Subversion (SVN) de SourceForge a eu lieu, afin de replacer les dossiers et structure dans leur contexte.

La version 1.2.2 Rc est passé dans une branche, afin conserver le suivi de cette version, et permettre de finaliser la 1.2.2Rc_c qui apportera quelques correction critiques

La version 2.1.0, qui correspondait à la branche de développement oscss2, permet la finalisation des quelques taches restante, et les modifications suite aux tests en cours. La sortie de la version 2.1.0 en pre-final devrait avoir lieux début septembre ; et la version 2.1.0 final dans les semaines suivantes. les derniers bugs corrigés

La version 2.1.1 est sur les rails, et correspond à la version de développement. Elle ce situe dans le répertoire trunk, et nous n'avançons pour celle ci aucune date de sortie.

Voir la roadmap sur les évolutions entre les versions

osCSS boutique en ligne Open Source - Free ecommerce

Convertion template osCSS 1 vers osCSS 2

Généralités

Séparation des contenus

osCSS Demo shop

Initialisation des boxes et modules

Fichier de template, appels

Howto Installation

Pre-requis technique

Avec la netinstall

Sans la netinstall

Utilisation de l'installateur d'extension

Finalisation de l'installation de votre boutique

Restructuration du dépôt Subversion de SourceForge