osCSS boutique en ligne Open Source - Free ecommerce

Le sitemap et ses menus

oscim — 2011-11-16T12:54:32Z

Le sitemap, disponible à l'adresse http://votreshop/sitemap.php, vous fournit une arborescence de navigation publique.

Il se compose des sections suivantes :

Catégories
Séléction
Mon compte
Information

Les catégories

C'est la fonction in_menu_cat qui prend en charge la construction de ces listes. Vous pouvez ajuster le comportement de celle-ci, voir.

La séléction

Il s'agit d'un menu en « dur », qui pointe vers les liens des promotions, petit prix, meilleur vente...

Mon compte

Fournit les liens vers les pages d'account.

Information

Liste l'ensemble des pages dont la clef commence par « informationBox_ ». Pour ajouter des pages à cette section, il vous suffit d'ajouter un article commençant par cette clef.

C'est ensuite la fonction in_menu_info qui se chargera de vous renvoyer la liste des articles.

function in_menu_cat()

oscim — 2011-11-16T11:16:26Z

Cette fonction appartient à la librairie template.php du dossier des fonctions.

Elle assure la construction d'une liste de catégorie multi-niveau.

echo in_menu_cat($arg);

Cette function support le passage d'argument sous la forme des GET, soit : arg = 'toto=1&tata=2' ;

Lors de la récupération des arguments par la fonction, celle-ci utilise tep_extrac_querystring pour re-transformer les arguments en un tableau clef/valeur.

Les arguments pris en charge :

max_level : profondeur de recursivité
catID : categorie racine de la recherche
ParentGroupString : le code de la balise html a utilisé pour encader les parents (ul) d'une liste ou sous liste

Page dans le backoffice, sélécteur css

oscim — 2011-10-20T20:08:30Z

Petit récapitulatif des sélécteurs Css présents dans le backoffice.

Les colonnes

Le contenu central, peut être utilisé à loisir, avec des colonnes à droite ou à gauche, et une colonne principale. Dans ce contexte de colonne vous pouvez utiliser les class de largeur permettant d'ajuster les largeurs de colonne :

w_20 largeur de 20%
w_30 largeur de 30%
w_40 ..
...

Pour positionner les colonnes, une class ajuste le flottant droit, gauche, ou le clear:both ;

fleft float gauche
fright flotant droit
clear

Main

Le titre de la page (h3) utilisera la class

main-title

Si un block est présent de type intro/text, l'utilisation de la class

main-intro

Les tables

Dans le cas des tables, pour obtenir le chargement jquery correspondant (dans le cas de tableau chargée via ajax) la class utilisée est

dataTable Même sans ajax, l'utilisation de cette class chargera le tri sur le tableau via javascript.

Au sein des tables, la colonne action est quelque peu spécifique. Elle utilise les classes dataTableRow view parent sur le "tr" ; De plus le "td" de la colonne action porte lui les classes row_action. Enfin il est possible de séparer 2 séries de bouton contenu dans des span. Si le span contient la class view fils, elle réagira au survol de la ligne.

par où commencer

oscim — 2011-10-02T08:55:27Z

Lors de votre connexion dans la partie privée de votre boutique, aussi appelée admin ou backoffice, vous vous retrouvez devant un menu et un tableau de bord.

Nous allons rapidement dresser un résumé des menus et tableaux de bord.

Le menu principal, vous fournis les éléments de gestion et suivi de votre boutique. Ce menu n'intègre pas les éléments de configuration et/ou modification de la structure et des fonctionnalités, mais uniquement des données, des commandes, des clients.

Il rassemble donc, votre suivi de commande, vos suivi client, vos produits et leur hiérarchie, vos pages de contenu, et l'aspect marketing à travers les newsletters.

Les entrée du menu principal

Chaque entrée, lors de son survol, vous donnée accés a un sous menu.

Outils (connexe, quelques outils de maintenance)
Clients (liste , édition, recherche, modification des client/membre inscrit )
Catalogue (liste des produits, édition, modification, gestion des attributs, des fabricants..)
Contenu (liste des rubriques/catégories édition et modification, liste de vos page, édition et modification et nu accès a l'organisation de vos menu public)
Commercial rassemble les élément d'ordre marketing, email et bulletin d'information
Commande, qui fournis les elements de suivi et modification des commande passées dans l'espace public

Autres boutons

Administration/Gestion ce bouton vous permet de switcher entre le menu de gestion (courant), et celui d'administration de la structure de la boutique , ajout de fonctionnalités, modification de la configuration
notification En permanence, vous avez un accès au notification, qui fourni une liste des événements métiers qui ont lieux dans l'espace public de votre boutique, nouvelles commandes, inscription client, demande d'information.
Visiter la boutique ce bouton vous renvoi dans l'espace public, même si la boutique est en maintenance (fermé au public)
Mon compte vous donne acces a vos information d'utilisateur, vous pouvez ainsi modifié vos email, mot de passe, nom..
Recherche (par type) vous donne un acces a une recherche rapide vers le type de donnée choisie (categorie, produit, client)

Les tableau de bords

Il propose un aperçu rapide a certaine informations métier, il sont affiché lors d'un clique sur l'une des entrée du menu principal , sans aller dans les sous menu

function the_description()

oscim — 2011-09-27T07:46:50Z

Cette fonction permet de charger le contenu d'un module , sans son titre. Lorsque l'on veut placer le contenu d'un module spécifique dans la page,cette fonction vous renvoi le contenu Si vous l'utilisez sans argument, elle renvoi le contenu du module desc_base (description produit) , vous pouvez lui spécifier un module, elle renverra dans ce cas le contenu du module spécifié. si aucun module correspondant n'est trouvé, elle renverra (...) - librairie template.php

Accès au data, tranversalité des appels aux données

oscim — 2011-09-27T07:28:48Z

La version 2.1.1 modifie quelque peu la topographie des fichiers, quant à l'accès aux données, et l'utilisation de l'appel à des données dans des page ou modules externe au type de données utilisé.

Je m'explique, la class permettant d'accéder et de manipuler les produits, à été déporté dans un dossier classes/driver. Il est donc accessible en permanence, au delà des pages spécifiques aux produits.

Cette forme d'écriture, permet de rendre l'acces et la liaison vers les données, et éventuellement leur modification plus synthétique, et centralisé.

L'interface

Un interface à été mise en place pour structuré la base de ces drivers, celui ci est présent dans class.interface.php.

Interface ModSqlDataDriver {
public static function create($option);
public static function update($option);
public static function fetch($option);
public static function delete($option);
}

Télécharger

Les drivers

Les drivers implémentant cet interface ne contiennent donc que des méthode public static. Il est donc simple de pourvoir les utilisé, en faisant référence à la class.

L'ensemble des arguments de ces driver sont composé par des tableau.

L'appel au produit d'id 5 aura lieux comme suit :

sqlproduct::fetch(array('id'=>5, 'language_id'=>1))

Liaison avec les modules ACA

Les drivers devant gérer les modules aca (produits/cat, post...) intègres dans le drivers l'appel au action des modules aca, assurant ainsi leurs prise en charge lors des modifications.

Dans la plupart des cas, il suffit d'utiliser la class ACAFactory pour obtenir la liaison vers ces module

Conclusion

A terme, l'ensemble des interactions sur la base de données transiterons par ces drivers, afin de simplifier la maintenance, et rendre plus simple les appels.

Ces drivers sont chargée en autoload, et ne nécessite donc pas d'être requis ou inclus avant utilisation.

Ajuster le comportement de la création des miniatures

oscim — 2011-09-17T08:03:27Z

Le moteur exploite une class centralisée pour manipuler et construire les images (miniatures). Cette class appartient au dossier commun (common), et est donc centralisée entre le backoffice et le front office.

Les besoins de l'espace public étant divers, plusieurs options sont possible afin d'ajuster le comportement de la class.

Ces options sont disponible à partir de la version 2.1.1.

Ratio des dimension de l'image

par défaut, lors de la création d'un miniature, les proportions de l'image source sont préservé, et l'ensemble redimensionné. Il peut être nécessaire de retailler les image sur un autre format, carré par exemple. Un driver pour la class image_ratio est disponible, afin de modifié le calcul des dimensions et proportion de l'image a traité

Pour exploiter un driver de la class image, il faut placer (dans le template) l'appel au driver souhaité Dans notre exemple, le driver ce nomme "Carre", ce qui nous donne

/** Force image carré */ image_ratio::SetModele('Carre'); ?>

A placer juste avant l'appel à tep_image() ou get_image(). Le driver Carre et fourni par défaut dans osCSS.

L'appel à un driver et ponctuel, aussi, il doit être appelé avant chaque appel à tep_image.

Watermark

La class supporte aussi le fait d'ajouter du texte par dessus l'image, pour protéger celle ci de la copie. Une option est disponible dans la configuration (voir image) permettant d'ajouter le texte à utiliser.

A partir du moment ou un contenu existe dans la configuration de la boutique, le watermak est actif, et sera appliqué à toute les nouvelles image créer.

Vous pouvez avoir besoin de désactiver cette fonctionnalité (image fabricants, catégories) ;

Utiliser le code comme suit avant l'appel des images qui ne doivent pas contenir le watermark :

/** Force image sans watermark */ image_ratio::SetWatermark(false); ?>

Pour réactiver le watermark, ou pour imposer sont utilisation, utiliser cet appel

/** Force image watermark */ image_ratio::SetWatermark(); ?>

Noter que le watermark ne fonctionne pas comme l'appel des driver, à partir du moment ou celui ci est actif, il est utilisé systématiquement sur toutes les images.

Note : Lors de l'appel a SetWatermark(), une image sera mise en cache, dans tous les cas. Même dans le cas d'un image ne nécessitant pas de redimensionnement. Cette usage assure le fait de pouvoir appliquer le watermark à toutes les images

Creer un module driver pour les images

La class image_ratio ne nécessite pas de driver pour fonctionner, et l'utilisation de l'un de est complément optionnel. L'ensemble des méthodes sont donc présentes dans la class image_ratio. D'autre part le driver Carre, est disponible et peut servir de modèle.

Tous les driver sont nécessairement une class extends de la class principal .

Liste des methode pouvant être remplacé par les drivers :

watermarkImage
aspectratio
thumbfile
thumbgd

Installation avec changement de langue

oscim — 2011-09-02T14:13:31Z

Vous pouvez déterminer le choix de votre langue lors de l'installation. Si vous effectuez ce choix avant l'installation, l'ensemble de la structure sera dans la langue choisie.

Pour installer une nouvelle langue, copiez l'ensemble du paquet osCSS dans un répertoire. Puis après avoir télécharger votre paquet de langue, copiez celui dans le répertoire dans lesquel vous avez extrait le zip d'osCSS.

Vous pouvez maintenant lancer l'installateur. Avec votre navigateur, pointez sur le répertoire dans lequel vous avez installé osCSS.

Vous serez redirigé vers l'installateur. Sinon ajouter /install à la fin de l'url.

Les pack de langue sont disponible sur le dépôt de sourceforge, il sont contenu dans le répertoire du paquet d'osCSS.

A ce jour, ici : http://sourceforge.net/projects/osc...

Gérer les liens du menu de l'admin

oscim — 2011-05-26T17:06:37Z

Petite explication , pour ne pas répéter la même info tout le temps :)

Dans l'admin, après une installation de module, il faut que le menu soit réinitialisé, afin qu'il prenne en charge les nouveaux menus et règle les droits d'utilisation .

Généralités

Si le menu n'est pas réinitialisé, alors aucune modification ne sera effectuée.

Pour ajouter des liens au menu, il est nécessaire d'être administrateur, c'est à dire le groupe premier (existe lors de l'installation).

Lorsqu'une extension ajoute un ou des menus dans le backoffice, lors de l'initialisation, les administrateurs auront tous les droits sur l'ensemble du menu.

Les réglages des droits ne peuvent être effectués que sur les groupes, les utilisateurs héritent des droits de leur groupe.

Utilisation

La seule action a exécuter après une installation d'extension est l'initialisation du menu.

Aller dans la page de votre compte "utilisateur".

Aller dans la section "caractéristiques", puis cliquer sur le bouton "init menu"

C'est fini !

Régle de nommage des fichiers de templates

oscim — 2011-04-07T07:08:59Z

Afin d'exploiter les différents fichier qui peuvent composer votre template, il est nécessaire de respecter quelques règle de nommage simple.

La manière dont les fichiers seront nommé déterminerons dans quelques contexte il seront utilisés . Le fichier principal du dossier de votre thème ce nomme template.php

Explication, exemple n°1 : Vous souhaitez mettre en place un fichier de template pour prendre en charge la structure d'affichage de la page création de compte (create_account).

Dans cette idée , vous dupliquer votre fichier de template principal (template.php) en un fichier nommé create_account.php.

C'est c'est alors ce fichier qui sera appelé pour structuré votre page.

Note, vous pouvez voir quel sont les fichier chargée en placant la valeur de "develop" à true dans votre fichier init.php.

Cette forme d'appel basé sur le nom de la page peut être utilisé pour toutes les pages.

Explication, exemple n°2 : Vous avez besoin de structurer de manière différente les pages associées au processus d'achat (checkout_xxx ). Nous allons utiliser cette fois la prise en charge des type de page dans la maniere de nommé notre fichier .

Les page associé aux page checkout_xxx sont de type "checkout".

Il est donc possible d'utiliser le nomage comme suit : checkout.template.php

Il est possible de mixer cette forme avec l'exemple précédent et obtenir par ex checkout.checkout_payment.php

Explication, exemple n°3 :

Fichier spécifique pour une categorie (et ces categorie enfants). Partons sur l'idée de la categorie portant le cpath 7. Vous pouvez imposer le template en utilisant un fichier nommé template.c_7.php

Dans le cas d'une sous catégories ( cpath 7_89), utilisé cette forme template.c_7_89.php

Note L'appel au fichier de de categorie ne fonctionne que pour les categorie. les produits ou page de contenu ne seront pas prise en charge

Explication, exemple n°4 :

Charger un fichier pour un produit donnée portant l'id 21. Utiliser un fichier nommé products_info.p_21.php ou template.p_21.php

Un fichier pour touts les produits donnerai donc products_info.php

Il est aussi possible pour les produit d'utiliser le type du produit, pour déterminer sont template template.type_1.php ou products_info.type_1.php