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.
EXT:b.it pagemenu¶
Author: | Kasper Skårhøj |
---|---|
Created: | 2002-11-01T00:32:00 |
Changed by: | Niels Behrendt |
Changed: | 2006-06-03T09:02:50 |
Author: | Niels Behrendt, b.it Dienstleistungen |
Email: | info@maker-it-typo3.de |
Info 3: | |
Info 4: |
EXT:b.it pagemenu¶
Extension Key: bit_pagemenu
Copyright 2000-2002, Niels Behrendt, b.it Dienstleistungen, <info @maker-it-typo3.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 www.typo3.com
Table of Contents¶
EXT: My Extension 1
Introduction 1
What does it do? 1
Screenshots 1
Users manual 1
FAQ 1
Adminstration 1
FAQ 2
Configuration 2
FAQ 2
Reference 2
Tutorial 2
Known problems 2
To-Do list 2
Changelog 2
Introduction¶
What does it do?¶
Die Erweiterung erstellt dynamisch aus den agelegten Unterseiten ein Teasermenü mit Bildern und Texten.
Screenshots¶
Users manual¶
Configuration¶
Wählen Sie im linken Menü den Punkt „Template“
Wählen Sie im Seitenbaum die Seite „root“
Wählen Sie das Haupttemplate aus „Auel booqit“
Wählen Sie in der Drop-Down-Box den Punkt „Constant Editor“
Wählen Sie die im Bereich „Category“ den Punkt „TX_BITPAGEMENU_PI1“ aus
Editieren Sie die Werte nach folgendem Schlüssel:
Template file: Speicherort der HTML-Vorlage zur Anzeige des Seitenmenüs. Hier können Sie Änderungen vornehmen, die die Darstellung beeinflussen
Image-wrap: Die hier angelegte Klammer X|Y umschließt jedes Bild in der Ausgabe nach dem Muster X <mein Bild-Tag> Y
Pic max height: die maximale Höhe des auszugebenden Bildes in px
Teaser text length: (250|…) gibt an, wie viele Zeichen des Textes (bodytext oder alternativ abstracts) angezeigt werden dürfen (250), und welche Zeichenfolge nach dem Abschneiden der restlichen Zeichen angezeigt werden soll (…).
Pix max width: gibt die Breite das Bildes in Pixeln an
How many pictures: definiert die Anzahl der auszugebenden Bilder
List of UIDs to exclude: gibt an, welche Seiten nicht angezeigt werden dürfen
Target of detail Link: definiert das Sprungziel
Klicken Sie auf „update“ um die Änderungen freizugeben oder einzelne Punkte für die Änderung zu aktivieren.
Reference¶
- Possible subsections: Reference (TypoScript)
templateFile¶
Property
templateFile
Data type
File
Description
Speicherort der HTML-Vorlage zur Anzeige des Seitenmenüs. Hier können Sie Änderungen vornehmen, die die Darstellung beeinflussen
Default
EXT:bit_pagemenu/bit_pagemenu.tmpl
pic.imagewrap¶
Property
pic.imagewrap
Data type
wrap
Description
Die hier angelegte Klammer X|Y umschließt jedes Bild in der Ausgabe nach dem Muster X <mein Bild-Tag> Y
Default
|<br />
pic.maxHeight¶
Property
pic.maxHeight
Data type
Int
Description
die maximale Höhe des auszugebenden Bildes in px
Default
90m
pic.maxWidth¶
Property
pic.maxWidth
Data type
Int
Description
gibt die Breite das Bildes in Pixeln an
Default
120m
TextLength¶
Property
TextLength
Data type
Crop
Description
gibt an, wie viele Zeichen des Textes (bodytext oder alternativ abstracts) angezeigt werden dürfen (250), und welche Zeichenfolge nach dem Abschneiden der restlichen Zeichen angezeigt werden soll (…).
Default
250|…
Target¶
Property
Target
Data type
string
Description
definiert das Sprungziel
Default
_self
CountPic¶
Property
CountPic
Data type
int
Description
definiert die Anzahl der auszugebenden Bilder
Default
1
ExcludUIDs¶
Property
ExcludUIDs
Data type
List
Description
gibt an, welche Seiten nicht angezeigt werden dürfen
Default
Tutorial¶
Wählen Sie im linken Menü den punkt „Seite“
Wählen Sie im Seitenbaum eine Seite, auf der die Übersicht erscheinen soll.
Klicken Sie sofern notwendig den Button „Seitentitel bearbeiten“ und wählen Sie den Seitentyp „erweitert“ oder „standard“
Legen Sie ein Seiteninhaltselement vom Typ „b.it Pagemenu“ an
Die Ausgabe erfolgt automatisch. Teasertexte und Bilder werden aus den Contentelementen der Unterseiten zusammengestellt. Unterseiten mit besonderen inhalten, die keinen „echten“ Inhalt haben, müssen für die Ansicht angepasst werden.
Wählen Sie als Seitentyp „erweitert“
Geben Sie den anzuzeigenden Teasertext in das Feld „abstracts“ (Inhaltsangabe) ein
Laden Sie die anzuzeigenden Bilder im Feld „media“ (Dateien) auf den Server
Important guidelines¶
Issues with Open Office documentation for TYPO3¶
There are a few important points to make about writing documentation for TYPO3 in Open Office. Please makes sure to follow these.
Inserting images¶
When you insert images you can either:
Make a copy/paste from eg. Photoshop, but it's REALLY IMPORTANT that you insert the image into Open Office by the menu “Edit > Paste Special” and then select “Bitmap” . If you don't do it in this way the image cannot be shown (since it will not be stored as a PNG internally in the SXW file)
Alternatively you can use the traditional way “Insert > Graphics > From file” and insert an image from your harddrive. In particular use this if the image is photographic (JPG) since the internal storage as PNG is not good for photographs.
Generally please use copy/paste only for screendumps with large areas of similar color (good png-compression) and JPG-files for photographic images. Go for small images, 72 dpi, medium quality.
Paragraph styles¶
- Use the paragraph style “Text body” for bodytext
- Use “Heading 1” to “Heading 5” for headers. “Heading 1-3” will be recognized as “sections” on typo3.org. “Heading 4-5” is subheaders, where “Heading 5” is preferrably for “Examples”.
- For code listings, use the style “Preformatted Text” (found under “HTML Styles”). For codelistings in tables there is a custom style called “Table Contents/PRE”.
This screenshot shows the only paragraph styles allowed in the documents. The ones grayed out are paragraph styles that are used by default for such as the index table or the footer. The others are the ones you are allowed to use.
Linking¶
You can make hyperlinks in the documents as absolute URLs. Use menu “Insert > Hyperlink”
Meta data and updates¶
There are three fields of meta-data you have to fill in. First of all go to “File > Properties...”.
In the “Description” screen you enter the title of the document. Extension manuals are prefixed “EXT: [extension title]”
In the “User defined” screen you enter your email address as the first field (named “Email” / ”Info 1”)
In the “User defined” screen you enter your full name as the second field (named “Author” / ”Info 2”)
Finally you should also insert the correct extension key in the text below the document title, but this is not a meta-data field, just regular text.
For more information you can go to typo3.org .
EXT:b.it pagemenu - 6