forked from xwolfde/Piratenkleider
-
Notifications
You must be signed in to change notification settings - Fork 0
/
readme.txt
379 lines (302 loc) · 16 KB
/
readme.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
Piratenkleider
- Wordpress-Theme für Webauftritte der Piratenpartei
=================================================
Version 2.9.2 von Wolfgang Wiese (xwolf), 20. Juli 2012
DOWNLOADS
Aus dem GIT-Repo (Letzte Arbeitsversion und Betas):
https://github.com/xwolfde/Piratenkleider
https://github.com/zwitschi/Piratenkleider (Österreich)
Projekt-Website (Releases)
http://piratenkleider.xwolf.de
CREDITS & COPYRIGHT
CC-BY-SA 3.0, http://creativecommons.org/licenses/by-sa/3.0/de/deed.de
AUTOREN / ENTWICKLER
Wolfgang Wiese (xwolf), http://www.xwolf.de
Mit Hilfe von
Andre Sendowski, http://www.iphone-notes.de/
Heiko Philippski, http://www.phindie.de/
Kerstin Probiesch, http://www.barrierefreie-informationskultur.de
Fabian Müller, http://www.feals.de
Georg Sinn, http://zwitschi.net
Quellen für Defaultbilder und CI-Materialen (CC-BY 3.0)
Defaultgrafiken für Slider/Seitenbilder: Tobias M. Eckrich
Weitere Bilder: Piratenwiki mit unterschiedlichen Autoren
Bildbearbeitung für Piratenkleider 2.x: Wolfgang Wiese
Weitere verwendete Inhalte:
Social Media Icons: Paul Robert Lloyd, http://paulrobertlloyd.com/2009/06/social_media_icons
YAML CSS Framework (Lizensiert unter der Creative Commons Attribution 2.0 License).
JavaScript Framework jQuery (GNU General Public License (GPL) Version 2)
jQuery FlexSlider (MIT License)
Schrift Bebas Neue von Dharmatype (SIL Open Font License 1.1)
Schrift Droid Sans von Ascender (http://www.droidfonts.com/), Apache License 2.0 http://www.apache.org/licenses/LICENSE-2.0
VORVERSION
Dieses Theme basiert auf die Wordpress-Basisvorlage von Korbinian Polk.
Das alte Original von korbinian kann auf github gefunden werden:
https://github.com/korbinian/Piratenkleider
MENÜS
Die Seite besteht aus drei verschiedenen Menüs.
- Hauptnavigation
Hierin werden alle statischen Seiten des Webauftritts aufgeführt, die
in der Hauptnavigation im oberen Teil der Seite, aber unter dem Logo
erscheinen.
Zu beachten ist, daß neben den Seiten des Webauftritts auch die
Startseite hinzugefügt werden muss. Unter der Option Menuüs
findet sich die Startseite, wenn man bei der Box
"Listen" auf "Zeige alle" klickt.
- Linkmenu
Hier befinden sich Links zu Werkzeugen oder Arbeitsportalen, wie
bspw. das Wiki oder das Forum.
Wenn diese Menü nicht definiert ist, wird es mit den Standardlinks
besetzt: Wiki, Liquid Feedback, Forum, Flaschenpost
- Technische Navigation
In das technsiche Menu kommen (statische) Seiten, die etwas über
den Webauftritt sagen, wie bspw. das Impressum, Kontakt, Credits.
Das technische Menü kann in der Sidebar "Fußbereich: Rechte Spalte"
durch anderen Inhalt überschrieben werden.
Die Menüs müssen unter Design->Menüs selbst angelegt werden und die
jeweiligen Seiten den Menus zugeordnet werden.
Diese selbst angelegten Menüs werden dann unter dem Punkt
"Anordnung im Theme" den drei genannten Bereichen zugeordnet.
Bei dem Menü, welches der Hauptnavigation zugeordnet ist, sollte die
Startseite der Website enthalten sein. Diese wird mittels CSS dann
in ein Häuschensymbol umgewandelt.
Sollte kein Menu angelegt und der hauptnavigation zugewiesen werden,
wird ersatzweise ein Menü ausgehend von den vorhandenen Seiten aufgebaut.
INHALTE
1. Alle Seiten und Artikel sollten Artikel/Seitenbilder haben, da diese
als Teaser angezeigt werden können.
2. Welche Artikel im Slider vorgestellt werden, wird in der Slider-
Kategorie-Einstellung definiert.
3. Besondere Artikel können auf der Startseite im Slider erscheinen.
Dies ist ein von selbst wechselndes Artikelbild mit der Verlinkung
zu einem Artikel.
Um dies für einen Artikel zu machen, muss der Artikel in der
für den Slider aktivierten Kategorie sein. (Siehe Punkt "Slider" unter den
Optionen "Takelage setzen")
Sollte ein Artikel über kein definiertes Artikelbild verfügen, wird
das Defaultsliderbilder verwendet.
BEREICHE/WIDGETS
1. "Sidebar (Rechte Spalte)"
Dieser Bereich befindet sich rechts vom Inhaltsbereich. Er ist geeignet für
Werbeplakate, Hinweise und ähnliches. Wenn leer, werden als Alternative
einige der allgemeinen Standardplakate gezeigt.
2. Sidebar 2 (Rechts unter Plakaten)
Dieser Bereich befindet sich rechts vom Inhaltsbereich. Er ist nach den
Werbeplakaten positioniert, die über die Optionen ein- oder abgeschaltet
werden können.
3. "Startseite: Sliderbereich"
Hier werden per default die Artikelbilder der 3 Artikel gezeigt, die
der Kategorie "Slider" zugeordnet sind.
Wenn das Widget mit einer anderer Funktion gefüllt wird, dann
entfällt der Slider.
4. "Startseite: Rechter Aktionlinkbereich"
Dieser Bereich ist rechts neben dem Slider. Auf der Piraten-Hauptsite
befinden sich dort 3 Links zu Spendern/Mitmachen und Mitglied werden.
Dieser 3 Teaserlinks können über die Theme-Option Takelage setzen
verändert werden. Wird das Widget genommen, wird dessen Inhalt jedoch
diese Änderungen überschreiben und der Widgetinhalt angezeigt.
5. "Startseite: Links unten"
Dies ist auf der Startseite der Bereich rechts neben der Liste der weiteren
Artikel.
Es empfiehlt das Widget mit der Schlagwortliste zu füllen.
6. "Startseite: Rechts unten"
Bereich rechts unterhalb der drei Presseartikel.
Wenn leer, wird hier eine Schlagwortliste gezeigt.
7. "Fußbereich: Linke Seite"
Bereich im Fußteil unter dem Haupttextbereich. Dieser Bereich eignet sich
insbesondere für externe Links zu anderen Piratenwebsites auf regionaler oder
überegionaler Ebene. Diese werden dann als Menu mit externen Links definiert
und dann als Widget dieser Sidebar zugeordnet. Wenn leer, wird hier nichts
angezeigt.
8. "Fußbereich: Rechte Spalte"
Rechte Spalte im Fußbereich. Wenn leer, erscheint hier das technische Menu
(siehe Menüs). Wenn auch dieses nicht definiert ist, wird die Blogadresse und
dessen RSS-Feedadresse gezeigt
THEME-OPTION "Takelage einstellen"
Unter der Option "Takelage setzen" sind die grundlegenden
Optionen für das Theme einstellbar:
- Newsletter-Box einschalten/abschalten
- Social Media Buttons ein/ausschalten
- Anzahl der Nachrichten auf der Startseite und dessen Anordnung
einstellen
- Slider steuern
- Teaserlinks ändern oder setzen
- Sticker ändern oder setzen
- Webadressen für Newsletter, Mitgliederanträge und Spenden anpassbar
- Metatag-Angaben ändern
- Optionale Anzeige für Seitenbilder steuern
- Menutyp für die Darstellung der Seiten und Unterseiten in der
Sidebar steuern.
Sowie viele mehr...
THEME-OPTION "Segel setzen"
Unter dieser Option lassen sich die Ersatzbilder festlegen, die angezeigt
werden, wenn Artikel oder Seiten kein "Artikelbild" besitzen.
Werden für den Slider keine Vorgaben gemacht, wird per Default die erste
Kategorie ("Allgemein") verwendet und Bilder per Zufall ausgegeben.
Ausserdem können hier die Werbeposter beim Slider in der rechten Sidebar
ausgewählt und über URL-Angaben zusätzliche definiert werden.
Werden keine Bilder vorausgewählt, werden alle Werbeposter im
Slider definiert.
Die Defaultbilder die in der rechten Sidebar als Werbeplakate erscheinen
liegen im Ordner /plakate/ .
Bei einem anderen Größe wird das Bild entsprechend durch den Browser
umskaliert. Dies kann jedoch mit Qualitätseinbußen verbunden sein.
Eine komplette Liste an Werbeplakaten, die von der Piratenpartei eingesetzt
wird, kann im Wiki unter der Seite http://wiki.piratenpartei.de/Plakate
gefunden werden.
Weiterhin können die Symbolbilder für die Metaseiten Suche, Tags, Kategorien,
Autoren, Archiv und Templateseiten über die EIngabe einer eigenen Bild-URL
geändert werden.
THEME-OPTION "Captn & Crew"
Diese Option dient der Eintragung von Kontaktinformationen für die
Templateseiten um das Impressum, die Datenschutzerklärung und
optionalen Formularseiten.
THEME-OPTION "Klüverbaum"
Diese Option ermöglicht die Änderungen spezieller CSS-Anweisungen im
Kopfteil der Seite, sowie das Einfügen eigener CSS-Anweisungen.
Ausserdem können hier die bekannten Farbcodes anderer Länder aktiviert
werden.
So ist es hier bspw. möglich anstelle der Wellen und dem Schiff
eine eigene Skyline als Hintergrundgrafik zu wählen.
Diese Optionenseite sollte nun vor erfahrenen Webadmins geändert werden,
die genau wissen was sie tun.
THEME OPTION "Kopfzeile"
Diese Option dient dazu, das Logo zu ändern und ein eigenes Logo
hochzuladen.
Wichtiger Hinweis:
Das Logo ist derzeit festgelegt auf eine Größe von 300x130 Pixeln.
Der Hintergrund sollte in RGB #eeeeee sein.
Leider werden alle Bilder die hochgeladen werden in JPG umgewandelt,
wenn sie es nicht schon sind. Die Qualität der Umwandlung ist jedoch
nicht so gut.
Aus diesem Grund empfiehlt es sich, das Logo in der passenden
Größe und dem Hintergrund über einem eigenen Grafikprogramm
vorzubereiten.
UNTERSTÜTZE PLUGINS
- Wenn das Plugin "Related Posts by Category" vorhanden und aktiviert ist,
werden bei der Anzeige eines Artikels weitere Artikel verlinkt, die
ggf. relevant sein könnten.
- Das Plugin "ICS Calendar" kann verwendet werden um Termin in Widgets
darzustellen.
Unter "Einstellungen -> "ICS Calendar" sollte dieses wie folgt
konfiguriert werden:
General Settings:
URL to ICS File(s):
zum Beispiel für Bayern:
1. http://events.piratenpartei-bayern.de/events/ical?gid=&gid[]=10&cid=&subgroups=1&start=&end=
2. http://events.piratenpartei-bayern.de/index.php/events/ical?gid=&gid[]=13&cid=
Formatting:
Date Format: "j.m."
Time Format: "G:i"
Custom Event Format: (Yes)
%date-time%, %start-date%, %start-time%, %end-date%, %end-time%,
%event-title%, %description%, %location%
Die Zeitzone sollte auf UTC-Time gestellt werden.
-Advanced Custom Fields
Mit Hilfe des Plugins Advanced Custom Fields können Seiten und Artikel um
zusätzliche Felder ergänzt werden.
Im Theme wird dies bei Seiten (nicht Artikeln) unterstützt durch den
optionalen Parameter “right_column”. Dieser erlaubt es, zusätzliche
Informationen in der rechte Spalte (der Sidebar) zu ergänzen.
Konfiguration von Advanced Custom Fields. Siehe Online Doku.
- The Events Calendar
Das Plugin "The Events Calendar" wird oft verwendet um eine
Terminkalenderansicht zu ermöglichen. Um diese optimal in das Theme
einzubauen, wurden eigene Templatefiles im Verzeichnis /events/ hinterlegt.
EMPFEHLUNGEN FÜR WIDGETS
1. Terminkalender mit "ICS Calendar":
Im Widget "Sidebar (Rechte Spalte) " sollte der ICS-Kalender für Termine
eingetragen werden.
Darunter folgt eine weitere Text-Widget mit dem Inhalt:
<a href="http:// .. link-zur-eventseite ...">Weitere Termine anzeigen</a>
(Leider verfügt das ICS Plugin in der aktuellen Version noch
über keine Einstellung hinsichtlich der Sparche des Links zu
dem Kalendersystem oder zu einzelnen Terminen. Daher ist es aus
Usability-Gründen derzeit besser, dies mit einem Textwidget danach
zu machen.)
Administrative Hinweise für Wordpress Theme-Editoren:
1. Default-Bilder
Die Auswahl der default-Bilder ist in Arrays in der Datei
theme-options.php abgelegt. Die Bilder liegen im Verzeichnis /images/
2. Default-Werbeplakate
Die Defaultbilder die in der rechten Sidebar als Werbeplakate erscheinen
liegen im Ordner /plakate/ .
3. Bilder in Inhaltsbereich, unter dem Menu
Bei Artikeln werden die jeweiligen Thumbnails der Artikelbilder
eingeblendet.
Dabei wird die Standardgröße für die Artikelbilder welche im Blog
festgelegt ist, verwendet. Bei neu eingerichteten Blogs wird die mittlere
Bildgröße verwendet, die in x und y maximal 300 Pixel definieren und
dann entsprechend umrechnen.
Unter Einstellungen-Mediathek sollte daher die mittlere Größe der Bilder
auf 740 Pixel Breite und 240 Pixel Höhe festgesetzt werden.
Bei Artikelbilder, die aber auf der Breite eine Höherskalierung bedürften
klappt dies nicht so toll. Die Y-Achse wird dann doch gross gemacht.
Daher sollte man darauf achten, daß nur solche Bilder gewählt werden die
auch tatsächlich entsprechend Breit sind.
Am Besten bearbeitet man die Sliderbilder vor.
Bei der optischen Darstellung des Sliders werden Bilder, die höher sind als
240 Pixel nach unten abgeschnitten.
4. Es können bis zu drei Sticker im Kopfteil der Webseite plaziert werden.
Unter der Theme-Optionen "Takelage setzen" kann man den Content
des Sticker sund die Ziel-Adresse eingeben.
Als Content kann HTML eingegeben werden um Bilder direkt einzublenden.
Es kann aber auch nur ein Text als COntent eingegeben werden.
Hierbei können über CSS-Klassen auch Farben und eine 5 Grad Drehung
für die Texte bestimmt werden.
Siehe hier zu die FAQ der Dokumentation für Beispiele.
Vorhandene CSS-Klassen für Texte:
cicolor = setzt die Farbe die jeweils als Grundfarbe des Designs
definiert ist. (Default: orange)
gedreht = Dreht den ganzen Text um 5 Grad
animate = Lässt den Text bei einem Hover sich drehen und skalieren
shadow = Gibt den Text einen Schattenwurf
(Bei gedrehten Text wird ein Schattenwurf automatisch gesetzt)
5. Die Teaserlinks rechts neben dem Bildslider auf der Startseite können
individuell über die Theme-Option "Takelage setzen" gesetzt
werden. Auch hier können bis zu 3 solcher Links eingegeben werden.
Symbol, Zieladresse, Titel und Untertitel sind
eingebbar. Titel und Untertitel sollten jedoch nicht länger als
40 Zeichen sein.
Das Symbol kann aus einer vorgegebenen Liste ausgewählt werden.
Die Teaserlinks können als Option auch als ganzes
deaktiviert werden indem ein Text-/Link-Widget in der
"Startseite: Rechter Aktionlinkbereich"
positioniert wuird.
6. Linkicons für bestimmte Dokumente werden über CSS gesteuert.
Um dies "abszuschalten", muss in der CSS-Datei style.css lediglich
das Stylesheet
@import url(css/basemod_linkicons.css);
auskommentiert werden.
Bei besonderen Links die nicht mit einem Icon ausgestattet werden sollen,
kann auch die Klasse .nolinkicon gesetzt werden.
Linkicons werden nur für den Inhaltsbereich gesetzt.
7. Farbcodes und Sprache der Texte
Laenderspezifische Farbcodes werden in den Dateien
/css/colors_tk.css (für Türkei)
/css/colors_lu.css (für Luxemburg)
/css/colors_at.css (für Österreich)
/css/colors_de.css (für Deutschland, jedoch nicht notwendig da Default)
abgelegt.
Diese greifen teilweise auf eigene Bilder zu.
Diese Bilder sollten in /images/ liegen wenn sie allgemein sind und
in /images/int/ wenn es um Bilder geht, die länderspezifisch sind.
Hinsichtlich der Sprachübersetzung von Texten können eigene Language-Dateien
in einem Verzeichnis /laguages/ abgelegt werden. Das Theme berücksichtigt
diese, wenn solche Sprachdateien vorhanden sind.
Zur Nutzung und Erstellung von Sprachdateien siehe
http://www.catswhocode.com/blog/how-to-make-a-translatable-wordpress-theme
Die Sprachdateien werden in der Form
Sprachcode_Landescode.mo und
Sprachcode_Landescode.po
abgelegt. Beispielsweise
en_UK.po
en_UK.mo
Um auf die andere Sprache zu wechseln wird im Backend und Settings die
Sprache auf die jeweilige Sprache gewechselt, sofern dies durch die
ortsabhängige Version der Wordpress-Installation nicht bereits geschehen ist.
Ab der Version 2.7 ist bereits eine britisch englische Sprachübersetzung
beigelegt.
Zur eigenen Übersetzung kann die Datei
default.po
mit Hilfe des Editors poedit bearbeitet werden.