Docstoc

Manual de Usuario STS

Document Sample
Manual de Usuario STS Powered By Docstoc
					                                                                                                                                                             1


                                                                 STS 4.5.8
                                       Actualizado el 16 de Diciembre de 2007 por Bill Kellum “bkellum”
                                                    (Traducción al español por “nicko107”)
Tabla de contenido

1 CONCEPTOS BÁSICOS SOBRE STS .................................................................................................... 3
    1.1 ¿QUÉ ES? ................................................................................................................................................... 3
    1.2 COMO TRABAJA STS (EXPLICACIÓN BÁSICA) ............................................................................................ 3
2 INSTALACIÓN .......................................................................................................................................... 4
3 COMO USAR STS: .................................................................................................................................... 4
    3.1 SIMPLE, UNA PLANTILLA DE UNA PÁGINA ................................................................................................. 4
    3.2 AGREGAR NUEVOS CAJAS O VARIABLES A LAS PLANTILLAS ....................................................................... 4
       3.2.1 Agregar nuevas variables en sts_user_code.php ................................................................................... 4
       3.2.2 Agregar nuevas variables en un nuevo archivo. ................................................................................... 4
    3.3 CAMBIAR EL NOMBRE DE LA PLANTILLA POR DEFECTO.............................................................................. 5
    3.4 CAMBIAR EL DIRECTORIO DONDE SE ENCUENTRAN LOS TEMPLATES .......................................................... 5
       3.4.1 Cambiar el diseño de la tienda .............................................................................................................. 5
       3.4.2 Pruebe un nuevo diseño solo para el administrador ............................................................................. 5
       3.4.3 Mover las templates fuera de includes/sts_templates ............................................................................ 6
    3.5 MODO DEPURACIÓN DE ERRORES DE STS. MODO DEBUG ......................................................................... 6
    3.6 CREAR UNA PLANTILLA PARA UNA PÁGINA CONCRETA DE SU CATALOGO ................................................. 6
    3.7 CREAR UNA PLANTILLA PARA UNA CATEGORIA CONCRETA ....................................................................... 6
    3.8 CREACIÓN DE PLANTILLAS PARA PAGINAS DE FABRICANTES ..................................................................... 7
    3.9 CREAR PLANTILLAS PARA PRODUCTOS ESPECIFICOS .................................................................................. 7
       3.9.1 Plantilla principal para cabecera (header), pie de paginas (footer) y columnas .................................. 7
       3.9.2 Plantilla para el contenido de la página................................................................................................ 7
       3.9.3 ¿Porqué una plantilla de contenido? ..................................................................................................... 7
       3.9.4 Modo compatibilidad con STS3 ............................................................................................................. 8
    3.10 CREAR PLANTILLA PARA VENTANA EMERGENTE IMAGEN AGRANDADA (POPUP IMAGE) ......................... 8
    3.11 CREAR PLANTILLAS DE CONTENIDO PARA CUALQUIER PÁGINA ................................................................ 8
    3.12 SUSTITUIR LAS IMÁGENES DE OSCOMMERCE POR DEFECTO .................................................................... 9
       3.12.1 Sustituir las imágenes originales, para todos los templates ................................................................ 9
       3.12.2 Sustituir las imágenes originales, para un template solo ................................................................... 11
    3.13 CREAR SUS PROPIOS BOTONES............................................................................................................... 12
       3.13.1 Indice de botones ............................................................................................................................... 12
       3.13.2 Sustituir botones de un template especifico ....................................................................................... 14
4 LISTA DE PLACEHOLDERS EXISTENTES ...................................................................................... 15
    4.1 PLACEHOLDERS GENERALES ................................................................................................................... 15
    4.2 PLACEHOLDERS PARA LOS MÓDULOS (INFOBOXES) DEL CATALOGO ....................................................... 18
    4.3 PLACEHOLDERS PARA EL CONTENIDO PRINCIPAL ..................................................................................... 19
    4.4 PLACEHOLDERS ESPECIALES PARA LA CABECERA HTML ........................................................................ 19
    4.5 PLACEHOLDERS PARA EL PIE DE PAGINA, FOOTER .................................................................................... 20
    4.6 PLACEHOLDER DE ETIQUETAS CREADAS POR EL USUARIO ....................................................................... 21
    4.7 PLACEHOLDERS PARA LA PLANTILLA DE CONTENIDO DE PRODUCT_INFO.PHP ......................................... 22
    4.8 PLACEHOLDERS PARA LA PLANTILLA PRODUCT_INFO.PHP EN MODO COMPATIBLE .................................. 24
    4.9 PLACEHOLDERS DE LA PLANTILLA POPUP_IMAGE.PHP ............................................................................. 25
5 TRUCOS Y SUGERENCIAS .................................................................................................................. 25
    5.1 URLS ABSOLUTAS ................................................................................................................................... 25
    5.2 AHORRE ALGO DE TIEMPO DEL PROCESO DE EJECUCIÓN .......................................................................... 26
       5.2.1 Cambie los nombres de los placeholder .............................................................................................. 26
       5.2.2 Código sin utilizar................................................................................................................................ 27
       5.2.3 Compresión GZip ................................................................................................................................. 27
    5.3 SUSTITUIR TITULO DE LA CABECERA DE LA PÁGINA CON EL NOMBRE DE CATEGORIAS O LA
    SUBCATEGORÍA (OPCIONAL) .......................................................................................................................... 27
    5.4 CREAR SU PROPIOS MÓDULOS DE STS (OPCIONAL) .................................................................................. 28
       5.4.1 ¿Por qué crear módulos de STS? ......................................................................................................... 28
       5.4.2 ¿Cómo? ................................................................................................................................................ 29
    5.5 CREAR SU PROPIO ARCHIVO PLACEHOLDER PARA INCLUIR (OPCIONAL) ................................................... 29
       5.5.1 ¿Por qué? ............................................................................................................................................. 29
       5.5.2 ¿Cómo? ................................................................................................................................................ 29
    5.6 CREAR IMÁGENES POR CADA (ID) IDIOMA DEL CATALOGO...................................................................... 30
       5.6.1 Cómo tener una imagen diferente por cada idioma en STS: ................................................................ 30
6 PLANTILLAS PARA MÓDULOS (INFOBOXES) .............................................................................. 30
    6.1 DESCRIPCIÓN ........................................................................................................................................... 30
    6.2 CAJA ALREDEDOR DEL LISTADO DE PRODUCTOS (PRODUCT LISTING) ...................................................... 32
    6.3 MÓDULOS O CAJAS CREADAS POR LOS ARCHIVOS DEL CATALOGO ........................................................... 32
    6.4 PLANTILLA INFOBOX TEST ...................................................................................................................... 34
7 FORO DE SOPORT................................................................................................................................. 34
8 STS POWER PACK................................................................................................................................. 35
1 Conceptos básicos sobre STS
1.1 ¿Qué es?
    STS es un sistema de plantillas para osCommerce Online Merchant 2.2MS2, RC1 y
    RC2 de fácil instalación. La parte gráfica de la tienda puede ser diseñada utilizando
    un editor html estándar como Dreamweaver, Expression Web o FrontPage.
    Si esta contribución le es de gran utilidad y quiere ayudar al constante esfuerzo de
    desarrollo, cualquier cantidad para la siguiente cuenta de paypal sería de gran
    motivación: paypal@osc-help.net . ¡Gracias!
    Chris "Rigadin2"

    Chris ha hecho un gran trabajo con STS y merece mucho reconocimiento por ello!
    Yo he modificado esta versión para funcionar con la ultima versiones de
    osCommerce Online Merchant RC1 y RC2 y he agregado las correcciones a errores
    (bugs) desde la versión v4.5.8. Yo no he incluido intencionadamente la incompleta
    versión v4.5.6 (con errores). Yo he agregado el placeholder $langid placeholder
    para manejar imágenes en distintos idiomas.
    También les pido que si usted encuentra esta versión útil, por favor, ayude en el
    apoyo y el desarrollo de futuras versiones de STS haciendo una donación de
    cualquier cantidad en mi cuenta de Paypal (billkellum@soundsgoodpro.com) o en
    mi sitio web en:
    http://soundsgoodpro.com/eshop/product_info.php?products_id=63

    ¡Muchas gracias y disfrute de esta contribución!
    Bill Kellum “bkellum”
    Para ser informado de cuando es actualizada esta contribución: www.osc-help.net

1.2 Como trabaja STS (explicación básica)

    En lugar de mostrar el resultado de los scripts directamente en el navegador web,
    STS “captura”el contenido de los scripts dentro de variables. Cada variable
    corresponde a un placeholder (por ejemplo "$banner") que puede ser colocado en
    una plantilla html. STS entonces sustituirá todos los placeholders por su
    correspondiente código y lo mostrará en el navegador web. Esto implica solo unas
    cuantas modificaciones en los archivos de osCommerce las cuales permitirán el
    cambio del diseño de su tienda simplemente modificando una página html.
    En su forma mas simple, solo es creada una plantilla que sería usada para todas las
    paginas de la tienda. También es posible crear una plantilla para cada página
    especifica, categoría, fabricante o producto especifico.
    He incluido una plantilla en “blanco” para mostrar que código es requerido en sus
    paginas HTML para crear sus propias plantillas. Usando esta plantilla en blanco,
    puede insertar varias variables (placeholders) que desee usar en su tienda para que
    coincida con su diseño HTML. Esta plantilla se encuentra en:
    “catalog/includes/sts_templates/test/sts_blank_template.html”
2 Instalación
   Consulte el documento aparte para la instalación. Después de la instalación, STS no
   estará activado y su tienda tendrá el mismo aspecto que antes. Continué leyendo aquí
   una vez haya completado la instalación,


3 Como usar STS:
3.1 Simple, Una Plantilla de una Página
   En el panel de administración de su tienda osCommerce, vaya a Módulos – STS.
   Instale y active el módulo “Default”. El aspecto de su tienda cambiará al diseño de la
   plantilla incluida en:

                                                                                             /c
               atalog/includes/sts_templates/test/sts_template.html

   Use una personalización de la hoja de estilo CSS o del diseño HTML para crear un
   aspecto personalizado de su sitio y organice como usted quiera los elementos
   (placeholders).

                                                                                             V
               ea el capitulo 3.3 si quiere cambiar el nombre de su plantilla.
                                                                                             V
               ea el capitulo 3.4 si quiere cambiar el directorio donde están colocadas las
               plantillas.
                                                                                             V
               ea el capitulo 4 para una lista de placeholders disponibles.



3.2 Agregar nuevos cajas o variables a las plantillas
3.2.1 Agregar nuevas variables en sts_user_code.php

      Si quiere agregar cualquier caja o nuevas variables para plantillas, agregalas en el
      archivo includes/modules/sts_inc/sts_user_code.php. Se incluye un ejemplo de
      sintaxis.

                                                                                                  V
                 er el capitulo 5.5 para conocer otra forma de crear nuevas variables.
3.2.2 Agregar nuevas variables en un nuevo archivo.

     También es posible crear nuevas variables en un archivo nuevo:

                                                                                               C
             rear un nuevo archivo php que contenga el código de las variables nuevas.
             Un ejemplo de código esta disponible en el archivo:
             “ includes/modules/sts_inc/sts_user_code.php”
                                                                                               P
             onga el archivo nuevo en el siguiente directorio:
             “includes/modules/sts_inc/ “
                                                                                               V
             aya al panel del admin y edite el módulo “Default”: agregue el nombre del
             nuevo archivo después de sts_use_code.php.
                                                                                               P
             uede haber varios nombres definidos aquí. Deben estar separados por
             punto y coma (ejemplo: sts_user_code.php;header_tags.php).



3.3 Cambiar el nombre de la plantilla por defecto
    Como verá más tarde, es posible tener plantillas para algunas paginas especificas.
    La plantilla por defecto es la utilizada si es mostrada una página que no tiene una
    plantilla especifica.
    Después de una instalación normal, la plantilla por defecto se encuentra aquí:

                                                                                           /
             catalog/includes/sts_templates/test/sts_template.html

    El nombre de la plantilla por defecto que es utilizada se puede cambiar editando el
    módulo “Default” del panel del admin.

3.4 Cambiar el directorio donde se encuentran los templates
3.4.1 Cambiar el diseño de la tienda
     Puede crear tantos directorios como quiera dentro del directorio
     “catalog/includes/sts_templates/” y colocar las plantillas en ellos. La elección del
     directorio en uso para la tienda se hace en la sección del admin, en el módulo
     “Default”. Puede usar esta función para cambiar entre varios diseños.

     Por defecto el template por defecto es “test” y solo contiene una plantilla. El
     directorio “full” contiene
     plantillas adicionales para la pagina de fabricantes, algunas categorías y una
     plantilla de contenido para el producto. Utilice el directorio “full” cuando conozca
     más sobre STS y quiera probar algunas posibilidades extra.
3.4.2 Pruebe un nuevo diseño solo para el administrador
     Es posible cambiar la template en uso desde la URL. Esto puede ser útil para
     probar un nuevo diseño sin molestar a los visitantes.
     Introduciendo la siguiente dirección URL, las plantillas del directorio “misitio”
     serán utilizados:
     www.sutienda.com/index.php?sts_template=misitio .


3.4.3 Mover las templates fuera de includes/sts_templates
     Desde la versión 4.4, el directorio “includes/sts_templates/”, que es donde se
     encuentran todos los directorios que contienen las distintas templates, puede ser
     cambiado desde la zona del admin, en el módulo “Default”. El parámetro que
     introduzca debería terminar con una barra “/” (sin las comillas), y es una dirección
     relativa con respecto a los archivos de su catalogo. Si su tienda esta localizada en
     “www.sutienda.com” y usted quiere tener las distintas templates en un directorio
     llamado “templates”, y usted está utilizando la template llamada “full”, sus
     templates estarían localizadas entonces en “www.sutienda.com/templates/full”.


3.5 Modo depuración de errores de STS. Modo Debug
    En el admin, seleccionar el módulo “default” de STS. Puede definir la contraseña
    de uso para acceder a la función de depuración de errores. Por defecto la contraseña
    es “debug”.
    Para ver la información de depuración de errores de index.php, escriba la dirección
    URL www.sutienda.com/index.php?sts_debug=debug.

    Verá entonces su pagina utilizando la plantilla de STS correspondiente como
    también la información de depuración de errores (información de la versión,
    template en uso, módulos en uso, archivos incluidos más todos los marcadores de
    posición (placeholders)). .


3.6 Crear una plantilla para una página concreta de su catalogo
    Puede usar múltiples archivos de plantillas basados en el nombre del archivo PHP
    que se esté ejecutando . Necesitará :
                                                                       Poner sus
            archivos de plantillas en el directorio de templates utilizando el siguiente
            formato para el nombre:
                                                                        “scriptname.php.
            html”
                                                                        Por ejemplo, una
            plantilla especifica para el archivo “index.php” podría ser:
                                                                         “/catalog/include
            s/sts_templates/full/index.php.html”
                                                                                           S
            i no hay definido una plantilla personalizada para un determinado script, se
            utilizará el archivo de la plantilla por defecto (definido en el módulo
            “Default”).

3.7 Crear una plantilla para una categoria concreta
    Puede utilizar varios archivos de plantillas que cambiarán acorde a la categoría
    seleccionada en el archivo index.php. La lógica para encontrar la plantilla se
    encuentra en el modulo "Index", por lo que este módulo debe ser activado en la
    zona del admin.

    Por favor, vea la documentación del módulo index para más detalles .




3.8 Creación de plantillas para paginas de fabricantes
    Desde la versión 1.0.2 del módulo “Index”, puede usar múltiples archivos de
    plantillas que serán utilizados acorde sea seleccionado el fabricante en index.php.
    La función para seleccionar la plantilla es realizada por el módulo “Index”, por lo
    que este módulo tiene que estar activado en la zona del admin.

    La lógica para escoger la plantilla que usar se encuentra en el módulo, por favor,
    vea la modulo_index.html para tener más información.


3.9 Crear plantillas para productos especificos
3.9.1 Plantilla principal para cabecera (header), pie de paginas
      (footer) y columnas
    Se puede tener varios archivos de templates distintos para mostrar la pagina de
    productos en detalle seleccionados en el archivo product_info.php.
    Las funciones para seleccionar la plantilla están en el módulo, por favor, lea la
    documentación del módulo product info para más detalles.


3.9.2 Plantilla para el contenido de la página
    Para cambiar la posición de los elementos del contenido de la pagina de
    información en detalle de un producto (product_info), tiene que crear una plantilla
    de contenido. El directorio para poner estas plantillas se llama “content” y debe
    estar dentro del directorio del template que se esté utilizando. Por ejemplo, si está
    utilizando el template “full” sería dentro de ese template en:
    includes/sts_templates/full/content.
    El módulo “Product info” debe estar instalado y activado para que este sistema
    funcione.
     Las funciones para seleccionar la plantilla están en el módulo, por favor, lea la
     documentación del módulo product info para obtener más información.



3.9.3 ¿Porqué una plantilla de contenido?
          Más flexibilidad para el diseño: puede tener una sola plantilla de contenido
           para todos sus productos, donde puede escoger el lugar donde mostrar el
           precio, la imagen y demás contenido, mientras la cabecera y las columnas
           cambian acorde a la categoría a la que pertenezca el producto. Sin plantilla de
           contenido, ¡tendría que crear una plantilla separada para cada producto para
           obtener el mismo resultado!
          Ejecutar el código para los marcadores de posición del contenido solo cuando
           exista una plantilla de contenido. En versiones mas antiguas de STS, este
           código era procesado para todos los productos incluso si no era necesario, lo
           que suponía tiempo de análisis muy lentos del código de las paginas.
          Para futuros desarrollos de STS: ser capaz de almacenar un cache de la parte
           la plantilla de contenido.

       NOTA: Si prefiere tener una sola platilla para toda la página, como en versiones
       anteriores de STS, puede activar el modo compatibilidad del módulo
       product_info.php. Ver el siguiente capitulo.


3.9.4 Modo compatibilidad con STS3
       Se activa en el módulo “Product info” de STS. En el parámetro “Enable STS3
       Compatibility mode” marcando “true”.
Cuando está activado este modo, y los usuarios visiten la pagina de información de
producto, STS procesara / “cargara” los datos de un fichero extra que contiene las
variables creadas específicamente para la plantilla de product info, y procesará esa
información incluso aunque no haya una plantilla de product_info (ni general, ni
especifica de la Id del producto). Por lo que si escoge esta opción asegurece de que su
plantilla de product info hecha para STS versión 2 o 3 contenga definidas todas las
variables. Pero tenga en cuenta que el tiempo de procesado de las paginas de productos
que usen la plantilla por defecto se incrementará, tanto como el número de variables que
deban ser procesadas se incremente (el mismo comportamiento se produce en STS 3 y 4).


3.10 Crear plantilla para ventana emergente imagen agrandada
    (popup image)
       Desde la versión STS 4.4, puede ser utilizada una plantilla para mostrar la ventana
       emergente de la imagen agrandada popup_image.php. Creando una plantilla
       llamada popup_image.php.html y guardada en el directorio del template.
    Las funciones para seleccionar la plantilla están en el módulo, por favor, lea la
    documentación del módulo popup image para obtener más información..


3.11 Crear plantillas de contenido para cualquier página
      Desde la versión 2.1.1 del módulo sts_default.php (incluido con STS v4.5) puede
      crear plantillas de contenido para cualquier página del catalogo que desee, sin
      tener que crear un nuevo módulo. Esto es particularmente útil cuando se crean
      nuevas paginas.
      El script del catalogo que está utilizando una plantilla de contenido debe incluir el
      nombre de la plantilla en la variable $sts->script->content_template_file, por
      ejemplo:
      STS_TEMPLATE_DIR . "content/mipagina.php.html";

      Una variable para una plantilla de contenido por defecto ya está contenida
      en la class sts:
      $sts->default_content_template y contiene content/sts_template.html

      Por lo que puede crear funciones en su script para verificar si existe una plantilla
      de contenido especifica, y si no existe usar entonces la plantilla por defecto que ha
      indicado en esa variable.

      Después, en su script tiene que crear un array con los nombres de los
      “placeholders” (marcadores de posición) y sus valores, placeholders que serán
      utilizados en su plantilla de contenido. El array utilizará el siguiente formato:
      $template_content ['nombreplaceholder'] = 'valorplaceholder';
      Ahora, en su plantilla de contenido puede usar: {$nombreplaceholder} (los
      paretensis y caracteres deben estar seguidos sin espacios entre ellos). ¡Es
      importante no cambiar el nombre del array!
      Si utiliza la plantilla por defecto para varias paginas, deberá estar seguro de que
      todas las páginas crean los mismos placeholders, incluso vacíos, para que no vaya
      a ver nombres de placeholder en su navegador.


3.12 Sustituir las imágenes de osCommerce por defecto
    Hay varios gráficos los cuales figuran en determinadas páginas del diseño estándar
    de osCommerce, que puede que usted desee sustituir o eliminar en aras de tener un
    diseño del sitio más coherente y sentir que tiene un sitio con un diseño único o
    exclusivo en lugar de uno recién terminado de desempaquetar. Hay dos formas de
    sustituir estas imágenes.

3.12.1 Sustituir las imágenes originales, para todos los templates

    Las imágenes del catalogo osCommerce se encuentran en el directorio:
    catalog/images/. Solamente tiene que sustituir esas imágenes por el conjunto de
      imágenes que usted quiera. Los cambios tendrán un efecto en todas las plantillas
      que tenga.

      En el cuadro que se muestra aquí se resume los nombres de los archivos y
      descripciones de muchos de los gráficos, para ayudarle con la sustitución de ellos.
      Si desea eliminar el uso de esos gráficos totalmente, que es la mejor opción para
      acceder a las paginas que los utilizan, y suprimir las etiquetas de las imágenes. No
      solo borre los archivos de las imágenes sin editar el código, ya que terminará con
      una situación aún peor con un sinfín de anuncios de imagen no encontrada por todo
      su sitio. La otra posibilidad es reemplazar la imagen con una transparente.



      Puede reemplazar las imágenes fácilmente si guarda las imágenes con el mismo
      nombre y directorio que el original:



                 Nombre del archivo                   Descripción             Localización

images/arrow_south_east.gif                     Flecha de color blanco Aparece en varios sitios
                                                que apunta hacia abajo y del catálogo
                                                derecha

images/arrow_east_south.gif                     Flecha de color blanco   Varias localizaciones
                                                apuntado derecha y
                                                abajo

images/arrow_down.gif                           Flecha apuntando abajo Varias localizaciones

images/table_background_default.gif             Persona en caja          En muchas páginas
                                                registradora             aparece arriba a la
                                                                         derecha, junto a la
                                                                         cabecera

images/table_background_payment.gif             Tarjetas de Crédito      Página Pedido

images/table_background_confirmation.gif        Recibo saliendo de una   Página confirmación
                                                máquina                  pedido

images/table_background_man_on_board.gif        Hombre traje y corbato   Página final
                                                sobre tabla de surf      confirmación pedido

images/checkout_bullet.gif                      Punto naranja            Marca pasos del
                                                                         proceso de pedido.
images/infobox/arrow_right.gif                          Flecha color blanco      Esquina superior
                                                        apuntando derecha        derecha de módulos
                                                                                 columnas, siempre de
                                                                                 enlace a otra página

includes/languages/espanol/images/icon.gif              bandera española         Módulo Idiomas
                                                                                 columna (también tener
                                                                                 en cuenta las otras
                                                                                 banderas de los otros
                                                                                 idiomas)

includes/languages/espanol/images/buttons/button_tell_a Sobre carta amarillo     Módulo columna
_friend.gif                                                                      Díselo a un amigo
                                                                                 (también versiones en
                                                                                 otros idiomas)

includes/languages/espanol/images/buttons/button_quick Lupa con estilo dibujos   Módulo columna
_find.gif                                                                        Búsqueda Rápida
                                                                                 (también versiones en
                                                                                 otros idiomas)

images/stars_1.gif                                      5 imágenes que varían    Varios localizaciones
a                                                       en la cantidad de        relacionados con
images/stars_5.gif                                      estrellas                valoraciones

images/table_background_reviews_new.gif                 Gente sobre un libro     Esquina superior
                                                                                 derecha de página de
                                                                                 comentarios

images/table_background_browse.gif                      Señal de madera de       Esquina superior
                                                        dibujos                  derecha de la página de
                                                                                 búsqueda

images/table_background_cart.gif                        Bolsas de compra         Esquina superior
                                                                                 derecha de la página
                                                                                 del carrito de compra

images/table_background_login.gif                       Hombre caminado         Esquina superior
                                                        haciendo dentro monitor derecha de la página de
                                                                                ingreso

images/table_background_account.gif                     Pluma escribiendo en un Esquina superior
                                                        libro                   derecha de la página de
                                                                                la cuenta

images/account_personal.gif                             Agenda y carpeta         Página Mi Cuenta

images/account_orders.gif                               Cajas con portapapeles   Página Mi Cuenta
images/account_notifications.gif                  Sobre estilo dibujos   Página Mi Cuenta



3.12.2           Sustituir las imágenes originales, para un template solo
Desde la versión STS 4.4, cada template puede utilizar su propio conjunto de imágenes.
Y si el template no encuentra una imagen, la imagen por defecto será la utilizada.

Para sustituir el lugar de una imagen en catalog/images/, ponga el archivo de la imagen
con el mismo nombre en: includes/sts_templates/[template set]/images/ y STS lo
utilizará.


3.13 Crear sus propios botones
       ¿Desea realmente que su template STS llame la atención? Cambie los botones
       estándar de toda la tienda para que sea acorde con su diseño.

3.13.1           Indice de botones

       La siguiente lista muestra los botones que necesitará crear para hacer un cambio
       completo de los gráficos de botones de osCommerce, y especifica sus nombres de
       archivo también. Los botones originales se encuentran en
       “catalog/includes/languages/espanol/images/buttons”
       Nota: Si usa otros idiomas a parte del “Español”, tendrá que guardar sus botones en
       sus correspondientes directorios de idioma también.

       Para utilizar diferentes botones para una sola template, mientras deja los botones
       por defecto para otros templates, leer la sección siguiente.

                                                                                            b
               utton_back.gif ……………….. Volver
                                                                                            b
               utton_buy_now.gif…………….Compre Ahora
                                                                                            b
               utton_change_address.gif………Cambiar Dirección
                                                                                            b
               utton_checkout.gif ……………. Realizar Pedido
                                                                                            b
               utton_confirm_order.gif ………..Confirmar
                                                                                            b
               utton_continue.gif ……………. Continuar
                                                                                            b
               utton_continue_shopping.gif …..Continue Shopping
                                                                                            b
               utton_delete.gif ………………...Eliminar
                                                           b
    utton_edit_account.gif…………. Editar Cuenta
                                                           b
    utton_history.gif …………….... Historial de Pedidos
                                                           b
    utton_in_cart.gif …………….... Añadir a la Cesta
                                                           b
    utton_login.gif……………….... Sign In
                                                           b
    utton_notifications.gif ………... Notifications
                                                           b
    utton_remove_notifications.gif ..Remove Notifications
                                                           b
    utton_reviews.gif …………….. Comentarios
                                                           b
    utton_search.gif …………….… Search
                                                           b
    utton_shipping_options.gif .….. Opciones de Envio
                                                           b
    utton_update.gif ……………… Update
                                                           b
    utton_update_cart.gif ……...…. Actualizar Cesta
                                                           b
    utton_add_address.gif……..….. Añadir Dirección
                                                           b
    utton_write_review.gif ……..… Escribir Comentario
                                                           b
    utton_address_book.gif…….…. Direcciones
                                                           S
    mall_delete.gif …………….…. delete (botón más pequeño)
                                                           S
    mall_view.gif…………………. view (botón más pequeño)
                                                           S
    mall_edit.gif………………..…. edit (botón más
    pequeño)utton_buy_now.gif.........Buy Now
                                                           b
    utton_change_address.gif............Change Address
                                                           b
    utton_checkout.gif ........................Checkout
                                                           b
    utton_confirm_order.gif ..............Confirm Order
                                                           b
    utton_continue.gif ........................Continue
                                                           b
    utton_continue_shopping.gif ......Continue Shopping
                                                                            b
    utton_delete.gif ............................Delete
                                                                            b
    utton_edit_account.gif..................Edit Account
                                                                            b
    utton_history.gif ............................Order History
                                                                            b
    utton_in_cart.gif ............................Add To Cart
                                                                            b
    utton_login.gif................................Login
                                                                            b
    utton_notifications.gif ..................Notifications
                                                                            b
    utton_remove_notifications.gif ...Remove Notifications
                                                                            b
    utton_reviews.gif ..........................Reviews
                                                                            b
    utton_search.gif ............................Search
                                                                            b
    utton_shipping_options.gif ..........Shipping Options
                                                                            b
    utton_update.gif ............................Update
                                                                            b
    utton_update_cart.gif ..................Update Cart
                                                                            b
    utton_add_address.gif..................Add Address
                                                                            b
    utton_write_review.gif ................Write Review
                                                                            b
    utton_address_book.gif................Address Book
                                                                            S
    mall_delete.gif .............................delete (half normal size)
                                                                            S
    mall_view.gif................................view (half normal size)
                                                                            S
    mall_edit.gif..................................edit (half normal size)
3.13.2                                          Sustituir botones de un template
      especifico

Desde la versión STS 4.4, cada conjunto de plantillas puede usar sus propios conjunto de
botones. Y en el caso de no haber un gráfico de un botón especifico, STS usará el que
viene por defecto de osCommerce.

Para sustituir un archivo de imagen localizado en
catalog/includes/languages/espanol/images/buttons, ponga el archivo de la imagen con el
mismo nombre en: includes/sts_templates/[template en uso]/images/[idioma]/buttons/
y STS los usará.
Por ejemplo, si está utilizando el template ( conjunto de plantillas) “full”, los botones en
español estarán en el directorio
includes/sts_templates/full/images/espanol/buttons/
                                                                                                    1
                                                                                                    6



4 Lista de placeholders existentes
4.1 Placeholders Generales
        Etiquetas soportadas por defecto en STS 4.5.8 (“por defecto” significa los
        marcadores que vienen ya con STS sin instalar aún ningún módulo extra)
        Estas etiquetas están disponibles para todos los archivos PHP / scripts
        y están creadas en el archivo:



     Marcador                                           Significado
   (Placeholder)


$date                 Fecha actual


$sid                  Cadena de caracteres con la Id de sesión usando el formato:
                      "SessionIdVarNombre=SeaCualSeaLaSesionIdEs"


$cataloglogo          Logo Tienda con enlace a index.php.

                      Antes de v4.3: oscommerce.gif en directorio catalog/images.

                      Desde v4.3: header_logo.gif, en directorio_template/images/espanol (o en otros
                      idiomas).


$urlcataloglogo       Dirección URL utilizada por el logo $catalog


$myaccountlogo        Botón gráfico de Mi Cuenta y con enlace a account.php.

                      Antes de v4.3: header_account.gif en directorio catalog/images

                      Desde v4.3: header_account.gif, en directorio_template/images/espanol (o en
                      otros idiomas)


$urlmyaccountlogo     Desechado en v4.3, utilice en su lugar $urlmyaccount


$cartlogo             Botón gráfico para ir al carrito de compra y enlace a shopping_cart.php
                      (página del carrito de compra).

                      Antes v4.3: header_cart.gif en directorio catalog/images enlazando a
                                                                                                1
                                                                                                7

                   shopping_cart.php (sin SSL).

                   Desde v4.3: header_cart.gif, en directorio template/images/espanol (o en otros
                   idiomas), enlazando a la misma pagina (con SSL si está presente).


$urlcartlogo       Desechado en v4.3, utilice en su lugar: $urlcartcontents


$checkoutlogo      Botón gráfico de Realizar Pedido y enlace a checkout_shipping.php.

                   Antes v4.3: header_checkout.gif en directorio catalog/images

                   Desde v4.3: header_checkout.gif, en directorio_template/images/espanol (o en
                   otros idiomas).


$urlcheckoutlogo   Desechado en v4.3, utilice en su lugar: $urlcheckout


$contactlogo       Agregado en v4.3: imagen header_contact_us.gif, que se encuentra en
                   directorio_template/images/espanol (o en otros idiomas), y enlaza a
                   contact_us.php .


$loginofflogo      Agregado en v4.3.

                   Si el cliente no ha ingresado en su cuenta: mostrará header_login.gif está en
                   directorio_template/images/espanol (o en otros idiomas), enlazando a login.php.

                   Si ha ingresado en su cuenta: mostrará header_logoff.gif está en
                   directorio_template/images/espanol (o en otros idiomas), enlazando a logoff.php


$breadcrumbs       El "Inicio > Catalogo > loquesea…" texto ruta de navegación (breadcrumbs)
                   y enlaces


$myaccount         La versión de texto de "Mi Cuenta" y enlace a account.php.


$urlmyaccount      Dirección URL utilizada por la función Mi Cuenta


$logoff            Texto salir / desconectar de la sesión, con enlace


$urllogoff         Dirección URL de la función LogOff (desconectar sesión)


$myaccountlogoff   muestra "Mi cuenta | Salir" si ha ingresado en la sesión o "Mi cuenta" si no ha
                                                                                                     1
                                                                                                     8

                   ingresado


$cartcontents      Versión texto función "Contenido del Carrito" ("Cart Contents")


$urlcartcontents   Dirección URL de pagina shopping_cart.php, usando SSL (si está
                   disponible). Bugeado (con errores) antes v4.3 (era lo mismo que $cartcontents).


$checkout          Versión texto función "Realizar Pedido" ("Check Out")


$urlcheckout       Dirección URL usada por la función "Realizar Pedido" ("Check Out")


$templatepath      Desechado en v4.3, utiliza en su lugar $templatedir


$templatedir       Contiene la ruta al directorio de la template, sin las barras /.


$headertags        Nuevo en v4.0.4: Los meta etiquetas para la sección de la cabecera del
                   documento html< head >. Aunque por defecto contiene solo la meta etiqueta <
                   TITLE >. Esta variable es insertada automáticamente dentro de la variable
                   $headcontent, por lo que no necesitará utilizarla en su plantilla.

                   Nota: Esta variable puede ser modificada por algunos módulos para permitir otras
                   meta etiquetas, por ejemplo un módulo de header tags controller modifica esta
                   variable para agregar la meta etiqueta description y keywords a las paginas.


$numrequests       Texto "1489 peticiones desde Viernes 11 Agosto, 2006"


$footer_text       La información de copyright de osCommerce y el texto "Powered By
                   osCommerce".


$banner_only       Banner, generalmente mostrado al final de las paginas.


$langid            Nuevo en v4.5.8: Esta etiqueta permite agregar la Id del idioma para vincular
                   las imágenes de acuerdo con el idioma seleccionado por el usuario.


     Para compatibilidad con STS v2 y v3, las variables $cat_ y $urlcat están creadas en
     sts_user_code.php pero están comentadas para que no sean procesadas. Ver
     apartado 4.6 para tener mas detalles.
                                                                                                        1
                                                                                                        9

4.2 Placeholders para los módulos (infoboxes) del catalogo
     Los placeholders / etiquetas para los módulos de las columnas del catalogo de
     osCommerce son las siguientes, que se encuentran en el archivo:
      “catalog/includes/modules/sts_inc/column_left.php”:

     Marcador                                            Significado
   (Placeholder)


$categorybox           Módulo menú Categorías


$manufacturerbox       Módulo de Fabricantes


$whatsnewbox           Módulo Novedades, en la columna


$searchbox             Módulo Búsqueda Rápida


$informationbox        Módulo Información


$cartbox               Módulo Carrito de Compra


$maninfobox            Módulo de Información de Fabricante, que se muestra en la página de producto
                       en detalle (vacío si no hay ID de producto en la URL de la página)


$orderhistorybox       Módulo Historial de Pedidos (no se muestra si el usuario no ha ingresado en su
                       cuenta)


$notificationbox       Nuevo en v4.0.4: Módulo Notificaciones de producto (vacío si la pagina no tiene
                       ID de producto). No utilizar esta etiqueta en conjunción con $bestsellersbox


$bestsellersbox_only   Nuevo en v4.0.5: Módulo Más Vendidos


$bestsellersbox        Muestra módulo Más Vendidos si la pagina no tiene ID de producto o si el
                       cliente ha ingresado en su cuenta y a solicitado recibir notificaciones de todos
                       los productos. En otros casos, mostrará el módulo de Notificaciones. No usar en
                       conjunción con la etiqueta $notificationbox ni con $bestsellersbox_only


$specialbox            Nuevo en v4.0.4: Módulo Ofertas, que muestra una oferta en la columna
                                                                                                    2
                                                                                                    0

$tellafriendbox     Nuevo en v4.0: Módulo “Díselo a un amigo” (no se muestra si la página no tiene
                    ID de producto)


$specialfriendbox   Muestra módulo “Díselo a un amigo” si se detecta una ID de producto en la
                    página y el visitante no está en la pagina de “Díselo a un amigo”, de lo contrario
                    mostrará el módulo Ofertas


$languagebox        Módulo Idiomas (vacío si se muestra la pagina de “Realizar Pedido”)


$currenciesbox      Módulo Monedas (vacío si se muestra la pagina de “Realizar Pedido”)


$reviewsbox         Módulo Comentarios. Desde v4.1, no se muestra en la pagina
                    product_reviews_info.php debido a un problema de visualización. El módulo y
                    esta página usan los mismos nombres de variables y hacen un lío la plantilla.




4.3 Placeholders para el contenido principal
     El contenido principal de la pagina (parte central de la página que contiene los
     módulos centrales, que no incluye header, footer ni columnas) se encuentra en la
     etiqueta $content.
     El contenido es tomado directamente desde el archivo PHP que se esté ejecutando.
     Por ejemplo, el $content de index.php es el código que puede encontrar en ese
     archivo catalog/index.php, entre la llamada de la columna izquierda (column_left) y
     la llamada de la columna derecha (column_right). Si quiere modificarlo, tendrá que
     modificar directamente el archivo PHP en si (catalog/index.php en el caso de ese
     ejemplo anterior).

     También puede utilizar plantillas para la parte del contenido solamente, ver ejemplo
     del episodio 3.9.2.




4.4 Placeholders especiales para la cabecera HTML

     Etiquetas importantes para poner en la cabecera (header) de las plantillas html:
                                                                                                     2
                                                                                                     1


 Marcador (Placeholder)                                   Significado


$htmlparams               Nuevo en v4.0.7: Dirección e idioma de la pagina de texto. Para poner en
                          la etiqueta html de la plantilla:
                          <html $htmlparams>

                          Más información http://www.w3schools.com/xhtml/xhtml_dtd.asp


<!–$headcontent–>         Etiqueta agregada en la cabecera del documento html de su plantilla.
                          Contiene el charset de la página, meta tags, base href y los javascripts
                          tomados del archivo header.php.

                          Debe usar este formato comentado (código que está entre <!– y –>) de
                          $headcontent para mantener la palabra "$headcontent" visible en programa
                          de edición web y ser reemplazado por su valor real.

                          NOTA: No ponga las etiquetas <title>…</title> en su header (cabecera
                          html). Esas etiquetas ya serán agregadas como parte de la variable
                          $headcontent .


<!–$extracss–>            Opcional. Permite colocar un enlace a una hojas de estilos CSS
                          dinamicamente. Será reemplazada por el contenido de $sts-
                          >template['extracss']. La línea completa debe ser colocada en, así <link
                          rel="stylesheet" type="text/css" href="stylesheet.css">

                          Debe usar este formato comentado de $extracss para mantener la palabra
                          "$extracss" visible en su programa de edición web y ser reemplazado por
                          el valor correcto.




4.5 Placeholders para el pie de pagina, footer

     Etiquetas que generalmente están en el pie de página de la tienda, creadas en el
     archivo “catalog/includes/modules/sts_inc/footer.php”:
                                                                                                       2
                                                                                                       2

 Placeholder                                            Significado


$numrequests       El texto"NNN peticiones desde DATE"


$footer_text       Nuevo en v4.0.5: texto del footer, proveniente de la constate
                   FOOTER_TEXT_BODY
                   (el texto: "Copyright ….. Powered by osCommerce")


$banner_only       Nuevo en v4.0.5: el banner, sin la tabla html



     Para ser compatible con plantillas hechas con STS v2 y v3, las variables $footer y
     $banner están creadas en sts_user_code pero se encuentran comentadas por defecto.
     Ver el siguiente apartado para obtener más información.

4.6 Placeholder de etiquetas creadas por el usuario
     El archivo “catalog/includes/modules/sts_inc/sts_user_code.php” está hecho para
     poner sus propias etiquetas. Ponga en ese archivo las etiquetas que usted cree.
     También puede crear un archivo nuevo en el mismo directorio, crear las
     etiquetas en ese nuevo archivo y configurar los módulos de STS para incluir ese
     archivo nuevo.

     El archivo “sts_user_code.php” ya contiene una etiqueta:
     Nota: Si no necesita este archivo, lo puede borrar del módulo de configuración de
     STS (módulo “Default”) y ahorrar así algo de tiempo de ejecución


          Placeholder                                          Significado


$catmenu                       Una lista en un desplegable de todas las categorías (incluyendo sub-
                               categorías)


$footer                        Incluye $footer_text así como la fecha y el contador de peticiones, dentro
                               de una tabla html. Para usar esta variable, descomentela del código.
                               Existente sólo para compatibilidad con STS v2 y v3


$banner                        El banner dentro de una tabla html. Para usar esta variable, descomentela
                               del código. Existente sólo para compatibilidad con STS v2 y v3


$cat_NombreCategoria,          Enlaces a categorías utilizando el nombre de la categoría. Disponible
                               para cada idioma. Ejemplo: $cat_Hardware. Para usar esta variable,
                                                                                                      2
                                                                                                      3

$urlcat_NombreCategoria      descomentela del código


$cat_IDdelaCategoria,        Enlaces a categorías utilizando el ID de la categoría. Es mejor utilizar la
$urlcat_IDdelaCategoria      ID que el nombre de la categoría, así al cambiar el nombre de la categoría
                             no se rompe el enlace. Ejemplo: $cat_2. Para usar esta variable,
                             descomentela del código



     Nota: sobre las variables $cat y $urlcat: para utilizarlas, descomentelas del código.
     Después, si el sistema no encuentra ninguna de estas variables dentro de la
     plantilla, las variables no serán cargadas, con el consiguiente ahorro de ejecución.
     Es recomendable no utilizar esas variables ya que es un proceso muy lento!

4.7 Placeholders para la plantilla de contenido de
    product_info.php
     Estas son las etiquetas que puede utilizar cuando cree plantillas para product_info.
     Son creadas en este archivo: “includes/modules/sts_inc/product_info.php”.
     Si quiere utilizar esta función, tendrá que “instalar” y activar el módulo “Product
     info” en la zona del admin en los módulos de STS:


   Placeholder                                          Significado


$productid          ID del producto que se está siendo mostrando. Agregado en v4.0.6 para ser
                    compatible con STS v3. Con errores hasta v4.3. Borrado en v4.3SP1, utilice en su
                    lugar $productsid


$productsid         ID del producto que se está siendo mostrando. Agregado en v4.0.6 para ser
                    compatible con STS v3. Con errores hasta la versión v4.3SP1


$startform          Requerido agregarlo el primero en el área de contenido. Comienzo del
                    formulario HTML necesario para agregar productos a su carrito.


$endform            Este debería ser lo último a agregar en el área de contenido. Cierra el formulario
                    HTML necesarios necesario para agregar productos a su carrito.


$regularprice       Precio del producto, sin oferta.


$specialprice       Precio en oferta, vacío si no está definido.
                                                                                                       2
                                                                                                       4

$regularpricestrike   Contiene el precio tachado "<s>$regularprice</s>" si specialprice (precio de
                      oferta) está establecido, de lo contrario contiene $regularprice (sin tachar).


$productname          Nombre del producto.


$productmodel         Número de modelo del producto.


$productdesc          Descripción del producto.


$imagesmall           Imagen de producto reducida al tamaño miniatura especificado en
                      herramientas de administrador en /admin/. Desde v4.0.7 estará en blanco si no hay
                      imagen de producto. Utilice $product_popup si quiere tener la opción de la imagen
                      agrandada en ventana emergente.


$imagelarge           Imagen de producto sin reducción (tamaño real de la imagen). Desde v4.0.7
                      estará en blanco si no hay imagen de producto.


$product_popup        Nuevo en v4.0.7: El Javascript con la imagen en miniatura del producto y un
                      enlace que lanza la ventana emergente que mostrará la imagen "agrandada".
                      Vacío si no hay imagen de producto.


$optionheader         Texto "Opciones:" que aparece después de la descripción si un producto tiene
                      varias opciones (atributos de productos) como "modelo", con un desplegable de
                      distintos modelos, el texto cambia según el idioma mostrado. No sale si no hay
                      opciones (atributos de productos)


$optionnames          Lista de Opción (Atributo de Producto) el nombre de la opción / atributo,
                      ejemplo: modelo, separados por un salto de línea ("<br>"). En blanco si no hay
                      opciones.


$optionchoices        Lista de Opción (Atributos de Producto) el menú desplegable (drop-down
                      menú) que contiene las distintas opciones de un atributo, separados por un
                      salto de línea ("<br>"). En blanco si no hay opciones.


NOTA: Como se indica en el archivo "/catalog/includes/sts_templates/test/product_info.php_26.html", se
recomienda que utilice una tabla HTML para mostrar las opciones (Atributos de productos). Que
en la primera columna tenga $optionnames y en la segunda columna tenga $optionchoices. Esto hará
que se muestre correctamente los nombres de las opciones seguidos de la selección. Utilice una tabla
sin borde (border="0")


$moreinfolabel        Texto multilingue mostrado por el valor de TEXT_MORE_INFORMATION
                                                                                                   2
                                                                                                   5

                    (Para obtener más información, visite la página …)


$moreinfourl        Dirección URL de la página donde se puede encontrar más información (Para
                    obtener más información, visite la página del producto)


$productdatelabel   Frase que contiene la Fecha de agregado o Fecha de disponibilidad (Este producto
                    esta en nuestro catálogo desde FECHA.) en cada idioma


$productdate        Fecha en que estará disponible el producto o la fecha en la que se agregó al
                    catalogo


$reviews            Texto con el número de comentarios de un producto. Vacío si no hay
                    comentarios disponible.


$reviewsbutton      Botón gráfico "Comentarios"


$reviewsurl         La dirección URL para los comentarios de productos


$addtocartbutton    Botón "Añadir a la Cesta" un producto.


$alsopurchased      La caja con los productos" también han comprado"



     NOTA: “Productos que también han comprado” aún no está implementada en las
     plantillas de Product_Info.


4.8 Placeholders para la plantilla product_info.php en modo
    compatible
     Si quiere crear plantillas para la pagina de información del producto “product
     info”, donde puede colocar los precios, imágenes y textos donde usted quiera, es
     ALTAMENTE RECOMENDABLE que use el método de plantilla de contenido.
     Si no quiere utilizar una plantilla de contenido para sus productos sino más bien
     utilizar una única plantilla la cual incluya las columnas, cabecera, pie de página,
     placeholders de “product info” (pero no $content), necesitará para hacer esto
     activar el modo compatible del módulo “Product info” de STS en el admin. Cuando
     este módulo esté activado, los mismos placeholders estarán disponibles como en el
     precedente apartado 4.7, además de $sysmsgs. Este placeholder deberá ser
     colocado donde quiera que los mensajes del sistema sean mostrados (Son la
     advertencias de la cabecera que avisan de archivos con permisos de lectura,
     existencia del directorio install.)
                                                                                                       2
                                                                                                       6

4.9 Placeholders de la plantilla popup_image.php
La plantilla para la página popup image (imagen “ampliada” del producto que aparece en
una nueva ventana) fue introducida en la versión 4.4 y no funciona con versiones
antiguas. Tenga en cuenta que los placeholders generados en general.php y
sts_user_code.php no están disponibles por defecto. Si quiere utilizarlos, tendrá que
agregar sus nombre en el módulo de configuración en el admin .
El módulo popup image debe estar activado en el admin, si no lo tiene activado la
plantilla para popup image será ignorada.

   Placeholder                                           Significado


 $productname        Nombre del Producto. Puede usarse como titulo de la plantilla.


 $productmodel       Modelo del Producto.


 $popupimage         Imagen del Producto.


 $back               Botón Imagen previa. Reservado para casos donde los productos tengan varias
                     imágenes.


 $next               Botón Imagen siguiente. Reservado para casos donde los productos tengan varias
                     imágenes.


 $count              Para mostrar algo parecido como 2/7 (imagen 2 de 7). Reservado para casos donde
                     los productos tengan varias imágenes.




5 Trucos y sugerencias
5.1 URLs absolutas
         Tiene que pensar con cuidado antes de crear enlaces en las plantillas que va a usar
         con osCommerce. Lo mismo se aplica a las imágenes, ya que hay bastantes
         posibilidades de tener problemas en el momento de enlazar con las imágenes
         cuando diseñe las plantillas y nuevas paginas para su tienda.
                                                                                        2
                                                                                        7
    Básicamente, usted estará en lo correcto en tanto los enlaces a sus imágenes sean
    relativos. Asegúrese de que sus enlaces son así “images/milogo.gif” y nunca de
    esta forma: “http://www.misitio.com/catalogo/images/milogo.gif”

    El segundo método de trabajo podría funcionar inicialmente, pero luego dará lugar
    a errores cuando cree un área segura de su sitio para manejar transacciones con
    tarjetas de crédito. En tales situaciones, incluso las imágenes deben ser transmitidas
    encriptadas para evitar alertas de seguridad. El problema es causado, porque
    especificaría que está utilizando el protocolo “http” y no el protocolo seguro
    “https”. Si piensa que la ruta que está poniéndole a las imágenes es correcta pero
    siguen sin aparecer las imágenes, compruebe que realmente ha subido las imágenes
    en el directorio correcto del servidor - este es un error que sorprendentemente es
    fácil de que pase.

5.2 Ahorre algo de tiempo del proceso de ejecución
5.2.1 Cambie los nombres de los placeholder
     Todas las variables creadas para las plantillas están situadas en un array que
     necesita ser ordenado antes de sustituir los placeholders, de modo que los
     placeholders se sustituyen a partir del nombre más largo al más corto. ¿Por qué?
     Mire estos dos placeholders:
     $prod contiene el texto “Hola”, $product_image contiene un enlace a una imagen.
     Si el array no es ordenado, el riesgo es que $product_image se convierta en
     $Hellouct_image durante el proceso de sustitución, rompiendo la plantilla.

     Al añadir un end char al final del placeholder, como $prod$ en vez de $prod, no
     se necesitará la ordenación de un array grande que contenga todos las variables de
     los placeholders.
     Para hacerlo, debe editar la plantilla, agregue el mismo end char a todos los
     placeholders, en nuestro ejemplo “$”, después hay que indicarle al sistema que
     utilice el end char. Esto se hace definiendo una constante en la plantilla: agregue
     este código al comienzo de su plantilla para indicar que está utilizando un end
     char:
     <?php DEFINE ('STS_END_CHAR', '$'); ?>

     Para plantillas de contenido, utilice este otro código:
     <?php DEFINE ('STS_CONTENT_END_CHAR', '$'); ?>

     El sistema detectará que se está utilizando un end char y no ordenará los array
     grandes.
     Si tiene varias plantillas, este método le permitirá modificarlas una por una. .

     NOTA: Puede utilizar los símbolos, $ o #, para obtener los mismos resultados.
     Algunas de las plantillas incluidas en STS ya usan el símbolo # y tienen ya
     insertado el código indicado arriba en el comienzo de la plantilla HTML.
                                                                                     2
                                                                                     8
      Hay un bug anterior a la versión 4.0.6: los placeholders se sustituían
      correctamente pero el array era siempre ordenado.


5.2.2 Código sin utilizar
      Puede comprobar en “includes/modules/sts_inc/sts_user_code.php” y en
      “general.php” (en el mismo directorio) si hay variables que nunca utilice y
      quitarlas del código.



5.2.3 Compresión GZip
     Desde v4.3.3 (4.3 SP3), la compresión GZip puede ser activada en el admin.
     Antes de esta versión, posiblemente hacerlo le mostraba una página en blanco.




5.3 Sustituir Titulo de la Cabecera de la Página con el nombre
    de Categorias o la Subcategoría (opcional)
    * Atención usuarios de HTC (Header Tags Controller) *
            No utilizar esta modificación si está usando la modificaciones hechas por
            Header Tags Controller en el archivo catalog/index.php. HTC usa una
            opción en el admin que dinamicamente agrega el título y descripciones de
            categorías.

    Deshacerse de “A ver que tenemos aquí ” de Subcategorías y Categorías con sub-
    categorías. Puede ser dinamicamente sustituido por el nombre de la categoría o
    subcategoría de la página que esté mostrando. Este es una buena modificación.


    En el archivo “/catalog/index.php”, aparece tres veces el siguiente código:
    <?php echo HEADING_TITLE; ?>

    PARA CATEGORIAS, es el que aparece primero:

             <?php echo HEADING_TITLE; ?>

    Sustitúyalo por:

             <?php echo $category['categories_name'] ?>


    PARA SUBCATEGORIAS, busque la segunda vez que aparece ese código:

             <?php echo HEADING_TITLE; ?>
                                                                                         2
                                                                                         9




    Sustituyalo por:

            <?php if (isset($HTTP_GET_VARS['manufacturers_id'])) {
                   $category_query = tep_db_query("select manufacturers_name from "
            . TABLE_MANUFACTURERS . " where manufacturers_id = '" .
            (int)$HTTP_GET_VARS['manufacturers_id'] . "'");
                   $category = tep_db_fetch_array($category_query);
                   if ($category['manufacturers_name'] != "") {echo
            $category['manufacturers_name'];} else { echo HEADING_TITLE;}
                 } else {
                   $category_query = tep_db_query("select cd.categories_name from " .
            TABLE_CATEGORIES . " c, " .
            TABLE_CATEGORIES_DESCRIPTION . " cd where c.categories_id = '"
            . (int)$current_category_id . "' and cd.categories_id = '" .
            (int)$current_category_id . "' and cd.language_id = '" . (int)$languages_id
            . "'");
                   $category = tep_db_fetch_array($category_query);
                   if ($category['categories_name'] != "") {echo
            $category['categories_name'];} else { echo HEADING_TITLE;}
                 }
            ?>

    No hace falta hacer una modificación a ese código la tercera vez que aparece
    <?php echo HEADING_TITLE; ?> por lo que déjela como está.




5.4 Crear su propios módulos de STS (opcional)
     osCommerce utiliza módulos como el de pago, de envío, de totalización que le
     permiten a usted fácilmente “activar/desactivar” opciones de su tienda en el panel
     de administración. ¿Podría ser más fácil?

5.4.1 ¿Por qué crear módulos de STS?
     Cada módulo se encarga de seleccionar la plantilla correspondiente para un
     archivo PHP o script particular.
     Si lo desea, puede crear una plantilla diferente para mostrar la pagina de nuevos
     productos o crear plantillas para mostrar artículos después de instalar una
     contribución.
                                                                                     3
                                                                                     0

5.4.2 ¿Cómo?
     La forma más fácil de hacerlo es copiar un módulo existente y renombrarlo
     usando el nombre del archivo PHP que quiere utilizar como plantillas. Si su
     archivo es articles.php, su módulo podría ser
     “includes/modules/sts/sts_articles.php”. En este módulo, tendría que hacer una
     modificación de la función “find_template” para seleccionar la plantilla que
     acorde al ejemplo sería la de la ID del artículo que se esté mostrando.
     Si quiere seleccionar una plantilla acorde a una página de fabricantes, tendrá que
     modificar el módulo “includes/modules/sts/sts_index.php” para que busque la ID
     del fabricante.


5.5 Crear su propio archivo placeholder para incluir (opcional)
5.5.1 ¿Por qué?
     Los archivos placeholder contienen código con las variables creadas que son
     utilizadas para reemplazar los placeholders de las plantillas. Este código puede
     ser insertado en el archivo sts_user_code.php, pero insertadolo en otro archivo a
     parte permite, vía configuración de módulos, limitar la ejecución del código solo a
     los módulos que necesiten esas variables nuevas.

     Ejemplo: Quiere crear nuevas variables para una contribución que muestra varias
     imágenes de un producto en la página en detalle del producto. Si las pone en el
     archivo sts_user_code.php, todas las páginas cargarán ese código aunque no sea
     utilizado, porque no se muestre la página de detalle del producto. Pero si los
     incluye en un archivo a parte y configura solo al módulo STS de “Product info”
     para que lo utilice, el código se ejecutará solo cuando sea necesario.

     Eso también lo hace más fácil de compartir con la comunidad de usuarios de STS.


     Ejemplo: alguien ha creado un archivo con las variables de la contribución Header
     Tags. Para usarlo, usted solo tendrá que copiarlo y configurar los módulos que lo
     usen, vía sección del admin de su tienda. ¿Podría ser más fácil?


5.5.2 ¿Cómo?
     Ponga el código en un archivo, y el archivo coloquelo dentro del directorio
     “includes/modules/sts_inc/” y configure los módulos que usarán este archivo en el
     admin.
                                                                                     3
                                                                                     1

5.6 Crear imágenes por cada (ID) Idioma del catalogo
5.6.1 Cómo tener una imagen diferente por cada idioma en STS:
     Usar una imagen diferente depende del idioma seleccionado por el usuario en su
     tienda. Esto se puede lograr haciendo lo siguiente:
     En STSv4.5.8 se ha creado un nuevo placeholder (etiqueta) y se encuentra en el
     archivo “includes/modules/sts_inc/general.php”. La nueva etiqueta STS se llama:
     $langid


     Cree las imágenes que quiera que sean escogidas según el idioma de la siguiente
     manera: miimagen1.jpg, miimagen2.jpg, miimagen3.jpg, etc, dependiendo del
     número de idiomas que tenga en su tienda, y guárdelas en su directorio de
     imágenes (o cualquier directorio de osCommerce como el siguiente
     images/banners).
          Puede ponerles el nombre que quiera a las imágenes pero que tengan el
     mismo, solo cambie el número acorde con la ID del idioma que representa. En
     otras palabras, no tiene que ponerles el nombre “miimagen”, las podría llamar
     “languagemenu1.gif” o “languagemenu2.gif” y así sucesivamente.

         El número de ID de cada idioma viene dado por su configuración especifica
     de osCommerce. Para saber la ID de cada idioma que tenga en su tienda, entre en
     su administración, y en el menú “Localización” mire en “Idiomas”, seleccione
     cada idioma y vea que ID tiene en la URL .

     Ahora agrege lo siguiente en su plantilla STS donde usted quiera que
     dinámicamente según el idioma aparezca la imagen:
     <img border="0" src="images/miimagen$langid.jpg">
     Cambie el nombre miimagen por el nombre de su archivo (sin poner el número).

     La etiqueta “$langid” de STS sustituirá dinámicamente la ID correcta del idioma
     que el usuario haya seleccionado cuando esté viendo su tienda.

            Por ejemplo: la ID del idioma español si es ID=3 la URL de la imagen
            escogida para mostrarse cambiara dinámicamente a
            “images/miimagen3.jpg” si el usuario selecciona el idioma “español” en la
            tienda.


6 Plantillas para módulos (Infoboxes)
6.1 Descripción
     Desde v4.3, el sistema de plantillas de módulos del catalogo o infoboxes está
     integrado dentro del paquete de STS y no se descarga separadamente. Este
                                                                                3
                                                                                2
sistema de plantillas para los módulos puede ser activado o desactivado desde el
módulo “Default” de STS en el admin.

Una plantilla de módulo contiene solo texto plano HTML, sin código PHP
incluido.
Puede editar estas plantillas con un editor visual HTML, como Dreamweaver,
FrontPage, etc.
Una plantilla de módulo o Infobox consiste en uno o dos archivos:
                                                                                    C
       abecera del módulo / Infobox Header (opcional):
       /includes/sts_templates/NOMBRE_TEMPLATE/boxes/infobox_header.ph
       p.html
                                                                                    C
       ontenido del módulo / Infobox Content:
       /includes/sts_templates/TEMPLATE_NAME/boxes/infobox.php.html

Esos dos archivos de arriba contienen solamente html con solo 3 etiquetas
(placeholders):

       $headertext - título del módulo / infobox
       $right_arrow - gráfico de la flecha orientada a la derecha que se
       encuentra en la esquina superio derecha de la cabecera del módulo.
       $content - contenido interior del módulo / infobox.

       Puede usar cualquier código html para sus módulos / infoboxes,
       simplemente insertándolo en las tres etiquetas de arriba.

Es posible crear plantillas para módulos individuales. Por ejemplo, si quiere que
el módulo de “Información” sea diferente de los otros, cree una plantilla a parte
para ese módulo creando los siguientes archivos:
     /includes/sts_templates/NOMBRE_TEMPLATE/boxes/infobox_informati
    on_header.php.html (opcional)
     /includes/sts_templates/NOMBRE_TEMPLATE/boxes/infobox_informati
    on.php.html

Incluya el nombre del módulo en la plantilla en el nombre del archivo siguiendo
el siguiente formato:
      infobox_nombremodulo.php.html

Si quiere editar el $content del módulo, como agregar una imagen al principio de
cada listado de categorías en su plantilla infobox_categories.php.html, necesitará
editar su actual archivo catalog/includes/boxes/categories.php para reflejar esos
cambios en su plantilla del módulo.
*Truco: Una forma sencilla de modificar uno de los módulos más importantes, el
del menú de Categorías, sería utilizar una de las muchas contribuciones para el
                                                                                      3
                                                                                      3
      menú Categorías que están disponibles en osCommerce.com. Aquí están dos de
      las que trabajan muy bien con STS :

                 1. Category Box as Nested Unordered
                    Listhttp://www.oscommerce.com/community/contributions,4201
                 2. "Dynamenu" for osCommerce
                    http://www.oscommerce.com/community/contributions,4228



6.2 Caja alrededor del listado de productos (product listing)
      El listado de productos original utiliza un class de boxes para crear un marco
      alrededor del listado de productos, pero para hacer esto no queremos utilizar la
      misma plantilla de módulos que para los otros módulos, por lo que desde la v4.4
      esta parte no utiliza el mismo sistema de plantillas que el diseño original de
      osCommerce.
      Desde v4.4, hay una plantilla para esta parte, que debería ser llamada
      infobox_product_listing.php.html y colocarse dentro del mismo directorio que las
      otras plantillas de módulos.


6.3 Módulos o cajas creadas por los archivos del catalogo
      Algunos archivos del catalogo como shopping_cart.php y advanced_search.php
      también utilizan las classes de boxes, por lo que esos archivos utilizarán la
      plantilla por defecto que puede tener un aspecto feo. Como los módulos /
      infoboxes pueden tener el mismo nombre que los archivos del catalogo: este es el
      caso de shopping_cart.php: el módulo o caja “Carrito de compra” que aparece en
      la parte superior de la columna izquierda, el archivo que lo genera tiene el mismo
      nombre que el módulo central de la página / archivo que muestra el carrito de
      compra por lo que debe haber una diferenciación entre las plantillas para los
      módulos centrales y para los boxes de las columnas del catalogo. Esto se hace
      desde v4.3SP1, las plantillas para los archivos del catalogo se encuentran en el
      mismo lugar que las otras plantillas de los módulos, pero tienen nombres
      diferenciados:
           catalog_nombrearchivo_header.php.html (opcional)
           catalog_nombrearchivo.php.html

      El conjunto de plantillas del “template” “full” incluye plantillas para
      shopping_cart.php y advanced_search.php (catalog_shopping_cart.php.html y
      catalog_advanced_search.php.html).

      Nota: la pagina shopping_cart.php utiliza una caja solo cuando el carrito de
      compra está vacío. Pruébelo.


Autor de “Infobox Templates for STS”:
                                                                                  3
                                                                                  4
Grigory Kopanev (gkopanev@mail.ru), modificado por Christophe Büchi aka Rigadin
(rigadin@osc-help.net) para STS v4.3
                                                                                         3
                                                                                         5



6.4 Plantilla Infobox Test
Active la template “full” en el admin:
En Admin >> Módulos >> STS: Módulo “Default”, escriba full en el parámetro
“Template folder” y active las plantillas de módulos en el parámetro que aparece al final
llamado “Use template for infoboxes” seleccionando “true”
Los módulos / infoboxes usarán ahora las plantillas definidas en
/includes/sts_templates/full/boxes/.
Si quiere esta función en su template, tal como “mis_plantillas”, “navidad” o
“primavera”, entonces lo único que necesitará es copiar el directorio “boxes” del template
“full” dentro del directorio de su template.




7 Foro de Soport
    El hilo de soporte que ha sido creado para STS v4.x:
    http://forums.oscommerce.com/index.php?showtopic=295660&st=0


    Por favor, postee sus cuestiones relativas a STS en ese hilo (use el enlace de
    arriba) para que toda la Comunidad STS pueda beneficiarse .
    Es una buena idea buscar en el foro para cualquier consulta que tenga antes de que
    cree un nuevo hilo.

    Si prefiere usar Google (www.google.com), puede utilizar el siguiente formato de
    búsqueda que le puede facilitar mejores resultados:

               "sts4" "double header" site:forums.osCommerce.com

    El ejemplo de arriba buscará primero “sts4″ en el foro de soporte de osCommerce, y
    luego buscará cualquier hilo sobre la cuestión “double header” (o lo que usted quiera
    consultar entre comillas)

    ¿Podría ser más fácil?
Aquí tiene otro ejemplo:

               site:forums.osCommerce.com "[Contribution] sts v4" "infobox"
                                                                                          3
                                                                                          6


    El ejemplo de arriba buscaría cualquier cosa con respecto a “infobox” en el hilo de
    soporte de la contribución STSv4.
Aquí tiene otro ejemplo:

              text edits site:www.osCommerce.info/

    El ejemplo de arriba buscará “text edits” en el “osCommerce Knowledge Base”. Esto
    está bien para encontrar las páginas que indiquen como guitar el texto genérico que
    viene por defecto en la tienda de osCommerce. 


8 STS Power Pack
    Asegúrese de visitar el sitio del STS Power Pack en
    http://addons.oscommerce.com/info/4456 Este sitio está lleno de nuevos
    complementos para STS y guías útiles. Otros usuarios han posteado sus correcciones
    y soluciones a problemas que pueda encontrar.

    Aquí tiene una corta lista de complementos disponibles en el sitio del STS Power
    Pack:


           Header Tags Controller (STS Power Pack)
           Ez new fields (STS Power Pack)
           Master Products (STS Power Pack)
           STS Tips, Tricks and How to’s Volume One
           Dynamenu & STSv4
           Custom Header and Footer Includes for STSv4x
           STSv4.3.3 and HTCv2.6.0 Bundle
           MoPics6 popup
           Add New Pages Using STS
           Top of page for STS
           QT Pro STS hack
           STSv4.5.2 and HTCv2.6.3 Bundle
           STS_MEGA_POWER_PACK_BUNDLE
           LIGHTBOX Image for STS 4+
           Attributes Sorter Copier for STSv4
           STSv4.5.2 and PRODUCT_EXTRA_FIELDS
           Dynamic Sitemap and STS
           STS and Marquee Text Banner
           Easy Meta Tags – CUSTOM Product Tags for STSv4
           Y más….
                                                                                   3
                                                                                   7
    Si viene con nuevas etiquetas STS personalizadas o soluciones que le gustaría
    compartir con la Comunidad de STS, le insto a que publique sus complementos en el
    sitio de STS Super Pack. ¡Espero ver su trabajo!




STS v4.5.8 documentación por Bill Kellum (billkellum@soundsgoodpro.com) of Sounds
Good Productions.



     Traducción al español por nicko107 (www.oscatalogo.com) 14 Diciembre 2008.

				
DOCUMENT INFO
Shared By:
Categories:
Stats:
views:15461
posted:2/15/2011
language:English
pages:37