DEPRECATION WARNING

This documentation is not using the current rendering mechanism and is probably outdated. The extension maintainer should switch to the new system. Details on how to use the rendering mechanism can be found here.

Wine Catalogue

Author:Kasper Skårhøj
Created:2002-11-01T00:32:00
Changed by:dirk
Changed:2015-07-28T15:16:17
Classification:wine
Description:Wine catalogue is a localized database with list and single views optimized for wines. It has a search form, an a-z-browser and a page-browser. English, German and Spanish is reday-to-use. It is based on the Browser -TYPO3 without PHP.
Keywords:wine, catalogue, browser
Author:Dirk Wildt (Die Netzmacher)
Email:http://wildt.at.die-netzmacher.de
Website:http://die-netzmacher.de
Language:en

img-1 img-2 Wine Catalogue (extkey: wine) img-3

Wine Catalogue

Responsive, ready-to-use, one-click-installation

Wine catalogue is a localized database with list and single views optimized for wines. It has a search form, an a-z-browser and a page- browser. English, German and Spanish is reday-to-use. It is based on the Browser -TYPO3 without PHP.

img-4

Version: 7.0.6 – 15-04-09

Extension Key: wine

Language: en

Keywords: wine, catalogue, browser

Copyright 2010 - 2015, Dirk Wildt (Die Netzmacher), <http://wildt.at .die-netzmacher.de>

This document is published under the Open Content License available from http://www.opencontent.org/opl.shtml The content of this document is related to TYPO3 a GNU/GPL CMS/Framework available from http://www.typo3.org/

Screenshots

Frontend

List View and jQuery Fancybox

Frame5 Frame5

Single View and Search Engine Optimization

Frame5 Frame5

Demo-Website

http://typo3-wine.de

Backend

Records

Frame5 Frame5

Plugin and Extension Files

Frame5 Frame5

Introduction

What does it do?

  • Wine Catalogue is a catalogue. It isn't any shop.
  • Wine Catalogue provides a data base for wine with regions, wineries, styles, varietals and ageings among others.
  • Wine Catalogue based on the extension Browser - the Frontend Engine (extKey: browser). Wine Catalogue has a template for the browser.
  • Both Wine Catalogue and Browser are out of the box.

Wine Catalogue supports localization.

  • English, German and Spanish is ready-to-use.
  • You have to create your own CSS only.

Dependencies

Wine Catalogue needs the extension Browser from version 7.x

Non possible features

  • Wine Catalogue doesn't support versioning.
  • Wine Catalogue doesn't support different workspaces.

Manual in PDF

Frame5

You find this manual as PDF file at

Installation

Extension Manager

  • Install this extension img-3 (wine).
  • Wine Catalogue will suggest to install the extension img-6 Browser - the Frontend Engine (extKey: browser). Please install it.
  • Wine Catalogue will suggest to install the extension jQuery Fancybox (extKey: jq_fancybox). Please install it.

Frame5

If you like to get the full power of Wine Catalogue and the Browser please install too:

  • RealUrl
  • Browser Tutorial Basics (en)

Page Tree

  • Insert the page "Catalogue"
  • Insert the sysfolder "Wine"

Frame5

Extension Template

  • Add an extension template to your page "Catalogue"
  • We recommend to use for the name of the template this syntax:
    • +type_page_templateID
    • We call it: +page_catalogue_017
  • Include the static templates from extensions:
    • Browser (browser)
    • Browser for Wine (wine)
    • jQuery Fancybox (jq_fancybox)

Frame5

Plugin

  • Add to your page “Catalogue” the plugin "Browser"
  • Choose as the startingpoint the sysfolder "Wine".

Frame5

Records

Please add to your sysfolder “Wine” some bottles of wine

Frame5

Result in the Frontend

You are finished. The illustration below displays the result in the frontend - if you have the same CSS and design like in our example.

Frame5

Real URL

If you like to use Real URL there is a configuration out of the box. See the file

res/realurl_conf.php

Wine Catalogue without jQuery Fancybox

If you don't like the jQuery Fancybox please use another template.

You find a template in the file:

res/setup_wo_jqfancybox.txt

Reference

This extension is a teamwork with the Browser.

Functional Schematic

Wine Catalogue is a Teamwork with the Browser

The illustration below is a illustration out of the Browser manual:

http://typo3.org/extensions/repository/view/browser/current/

Frame5 Frame5

The common way of TYPO3 extension development:

  • Extensions have there own frontend plugin.
  • Extensions have own PHP code for the frontend rendering.

TYPO3 extension development with the Browser:

  • Wine Catalogue hasn't any own frontend plugin.
  • Wine Catalogue has a TypoScript template for the Browser extension only.

We developed the Wine Catalogue extension in teamwork with the Browser like in the illustration above on the right hand, because we could save a lot of development costs. And it is a good idea for the future too. We will be able to extend the database in the backend and the rendering in the frontend very flexible and cost-effective.

If you want to change the design or some functionality in the frontend you have to change the TypoScript of the extension Browser.

plugin.tx_browser_pi1

If you want to investigate the Wine Catalogue TypoScript template, take a look in

  • the TypoScript Object Browser or in
  • static/setup.txt (below you find a cutout).

There are three good reasons to investigate the TypoScript:

  • You want to change a view in the frontend.
  • You want to add new tables or fields in the Wine Catalogue database.
  • You want to use the Browser for your own database.

If you understand the snippet below, you should be able to change a lot of functionality in the frontend and to use the Browser as the frontend plugin for your database with a minimum of costs.

Please respect that this manual is the Wine Catalogue manual and not the Browser manual. If you like an in-depth analysis take a look in the Browser manual.

http://typo3.org/extensions/repository/view/browser/current/

TypoScript Object Browser

Frame5

Be aware:

  • There is no plugin: tx_wine_pi1
  • There is a plugin: tx_browser_pi1

If you want to add or delete a view or add or delete a table field in a view please open the array

tx_browser_pi1.views

Profile of Wine Catalogue

There are some examples with extensions, which are using the extension Browser:

wine

juridat

ships (non published)

civserv

Wine Catalogue is a very good example, if you are interested in localization.

  • We have a localized main table.
  • We have translated foreign tables.

The Browser has a tutorial for localization. See

http://typo3.org/extensions/repository/view/browser_tut_localizatio n_en/current/

TypoScript

Cut out of static/setup.txt

plugin.tx_browser_pi1 {

views {

list {

1 {

select (

tx_wine_main.title,

tx_wine_main.image,

tx_wine_main.imagealttext,

tx_wine_main.imagetitletext,

tx_wine_year.title,

tx_wine_region.title,

tx_wine_winery.title,

tx_wine_main.price,

tx_wine_main.price_display,

tx_wine_main.currency

)

}

}

single {

1 {

select (

tx_wine_main.title,

tx_wine_year.title,

tx_wine_main.image,

tx_wine_main.imagealttext,

tx_wine_main.imagetitletext,

tx_wine_region.title,

tx_wine_winery.title,

tx_wine_maintype.title,

tx_wine_subtype.title,

tx_wine_varietal.title,

tx_wine_main.ageing,

tx_wine_alcohol.title,

tx_wine_acid.title,

tx_wine_temperature.title,

tx_wine_drinkability.title,

tx_wine_main.price,

tx_wine_main.price_display,

tx_wine_main.currency,

tx_wine_main.short,

tx_wine_main.description

)

}

}

}

}

Tutorials

The Browser has a lot of tutorials.

If you like to adapt the Wine Catalogue to your needs, please take a look into it.

Please refer to

http://typo3-browser.de/tutorials/

Helpful suggestions

Forum

If you have helpful suggestions, feel free to publish any question, bug or code snippet on

http://typo3-browser-forum.de/

Credits

VCA - Vinos de Aragón - has sponsored a part of the extension Wine.

Further Information

Demo website

You find a Quick Shop demo at

http://typo3-quick-shop.de

Manual and tutorial in PDF

You find this manual and the tutorial in PDF format at

  • doc/manual.pdf
  • doc/tutorial.pdf

Professional Support

If you need professional support, please contact the Developer:

Dirk Wildt http://wildt.at.die-netzmacher.de/

E-Mails are welcome in English and German.

Other extensions published by Die Netzmacher

  • img-7 +AOE Linkhandler Configurator: Configure the AOE linkhandler supported by userinterfaces. Out-of-the-box templates for cal, org, tt_news and tt_products. Don't edit page TSconfig any longer. http://typo3.org/extensions/repository/view/linkhandlerconf/
  • img-8 autositemap: A smart site-map optimised for the footer. It groups menus in columns. Great menus will get two columns. Configuration is based on TypoScript HMENU. http://typo3.org/extensions/repository/view/autositemap/
  • img-9 Browser – TYPO3 without PHP. Develop your TYPO3 extension 8 times faster! You need one line TypoScript for a result list with a search form, a record browser and an index browser. Images are wrapped self-acting. SEO, Search Engine Optimization, is integrated. http://typo3.org/extensions/repository/view/browser/
  • img-10 Caddy – the TYPO3 shopping cart. You can use it for your own needs. You need a database with products or any other items only. You can install Caddy out of the box with one mouse click – see Quick Shop below. http://typo3.org/extensions/repository/view/caddy/
  • img-10 Deal! – TYPO3 Quick Shop interface for the marketplace ebay. Manage all items with TYPO3 and publish it on ebay. Amazon is under construction. http://typo3.org/extensions/repository/view/deal/
  • img-11 Duty – collection of helpful scheduler tasks. Here: remove deprecated files from directories. http://typo3.org/extensions/repository/view/duty/
  • img-12 Flip it! offers lovely and smooth page flip transitions. It enables you to run over pages in PDF documents like in a real magazine. It is based on flash. Flipt it! can convert PDF documents to swf files automatically. http://typo3.org/extensions/repository/view/flipit/
  • img-13 Jobmarket is a catalogue with job offers. Views, the a-z-browser, the page-browser, the search, social bookmarks and a lot of other stuff can configured by the Browser plugin with the mouse. Job Market hasn't any PHP code, it should be easy to adapt it to your needs. http://typo3.org/extensions/repository/view/job_market/
  • img-14 Organiser – TYPO3 for the lobby and the organisers. Handle news, events, staff, headquarters, locations, workshops and a calendar with one extension. Sell online tickets! Install the Organiser with one mouse click! http://typo3-organiser.de/
  • img-10 Quick Shop – the fastest shop in the history of TYPO3. Install it with one mouse click! Quick Shop is based on the browser (see above) and powermail. http://typo3-quick-shop.de/
  • img-15 PDF Controller: Easy to install. Add to your HTML page the PDF-controller-button. Link from the button to the controller. Adjust the controller by mouseclicks. The PDF Controller supports CSS 3. http://typo3-pdfcontroller.de/
  • img-16 Radial Search (Umkreissuche) – Enable the browsing through your data by geo location. 'Your data must have a latitude and a longitude. Address data can geocoded automatically by the Browser - TYPO3 without PHP. http://typo3.org/extensions/repository/view/radialsearch/
  • img-16 Route – Publish your routes with GoogleMaps or OpenStreetMap. Routes have points of interest (POI). You can categorise and filter both: routes and POI. Address data can geocoded automatically. http://typo3.org/extensions/repository/view/route/
  • img-17 seo_dynamic_tag: Search Engine Optimization for the title tag, the canonical tag and the meta tags author, description and keywords. Configuration by a user interface. http://typo3.org/extensions/repository/view/seo_dynamic_tag/
  • img-18 Slick - jQuery Carousel: Fully responsive. Scales with its container. Separate settings per breakpoint. Uses CSS3 when available. Swipe enabled. Desktop mouse dragging. Infinite looping. Fully accessible. http://typo3.org/extensions/repository/view/slick/
  • img-19 TSconfig Pages and Users by extManager (extkey: tsconf): Configure the the eight most commonly used TSconfig porperties with the mouse - like page tree uids, activated extended view, activated clipboard, ... http://typo3.org/extensions/repository/view/tsconf/

Change Log

7.0.6 Improvements #i0003: replace fieldmarker (###) by field names

6.0.0 Upgrade * #i0002: New template file structure* #i0001: TYPO3 6.x and Browser 7.x

1.1.2 Improvement * Update to browser 3.9.24

1.1.0 Improvement * Update to browser 3.7.0 (new feature: record_browser)* default.tmpl* single view got an id* single view got the marker for the record browser ###RECORD_BROWSER###* Template is integrated into the plugin/flexform

1.0.1 Improvement * Proper localized values

1.0.0 New Feature * #9659: AJAX* default.tmpl* pagebrowser is moved from above the search form to below the search form* reset button got the class reset* listarea is wrapped with <div class="listarea">...</div>

0.0.1 Initial release

Illustration Index

Illustration 1: List view 3

Illustration 2: List view with Fancybox 3

Illustration 3: Single view3

Illustration 4: Search Engine Optimization: Real URL, title, description, keywords 3

Illustration 5: List view 4

Illustration 6: Single view 4

Illustration 7: The Browser plugin - there are three tabs for important properties. Others are configured by TypoScript. 4

Illustration 8: Small but powerful. No plugin, no PHP - enabled by the Browser 4

Illustration 9: Manual in PDF format 5

Illustration 10: Extension Manager with Browser and Wine among others 6

Illustration 11: Page "Catalogue" and sysfolder "Wine" 6

Illustration 12: The extension template includes the templates browser, wine and jq_fancybox 7

Illustration 13: Plugin Browser with the startingpoint "Wine" 7

Illustration 14: Sysfolder with some bottles of wine 8

Illustration 15: Sysfolder with some bottles of wine 8

Illustration 16: Common way of the TYPO3 extension development. 9

Illustration 17: TYPO3 extension development with the Browser. 9

Illustration 18: TypoScript Object Browser with the tx_browser_pi1 array 10

Alphabetical Index

Demo 15

Documentation

PDF 15

Support 15

19