Wikizone - Benutzerbeiträge [de]

ProcessWire - RSS Feed

2026-01-15T16:04:35Z

109.193.152.88:

Wenn man einen RSS Feed benötigt gibt es im Core von ProcessWire bereits ein Modul.
MarkupRSS
Es kann bei den Core Modulen aktiviert werden.

Im Template kann an es so z.B. nutzen:

Beispiel TV Altötting
<syntaxhighlight lang="php">
<?php namespace ProcessWire;

$departmentName = strstr($page->template->name,'-',true);
$limit = 10; // default limit
$sort = '-modified'; // default sort

// feed on?
if($page->fp_feed && $page->fp_feed->opt_1){
echo('Der Feed ist für diese Seite nicht aktiv. Du kannst ihn in den Seiteneinstellungen aktivieren');
exit();
}
// feed count
if($page->fp_feed && $page->fp_feed->feed_count) $limit = $page->fp_feed->feed_count;

$departmentPostTemplate = $departmentName.'-post';
$feedTitle = $page->title.' - Aktuelles';
$rss = $modules->get("MarkupRSS");

$selector = "template=$departmentPostTemplate, limit=$limit, sort=$sort";

// configure the feed. see the actual module file for more optional config options.
$rss->title =$feedTitle;
$rss->description = "Aktuelle Informaionen";
$rss->itemContentField = 'infotext';
$rss->itemDescriptionField ='infotext';
$rss->itemDateField = 'date_begin';

// find the pages you want to appear in the feed.
// this can be any group of pages returned by $pages->find() or $page->children(), etc.
$items = $pages->find($selector);
// send the output of the RSS feed, and you are done
$rss->render($items);
exit();
</php>
</syntaxhighlight>

ProcessWire - RSS Feed

2026-01-15T16:04:12Z

109.193.152.88:

ProcessWire - RSS Feed

2026-01-15T16:03:45Z

109.193.152.88: Die Seite wurde neu angelegt: „Wenn man einen RSS Feed benötigt gibt es im Core von ProcessWire bereits ein Modul. MarkupRSS Es kann bei den Core Modulen aktiviert werden. Im Template k…“

ProcessWire - Job Template

2025-12-12T08:39:42Z

109.193.152.88:

== Links ==
ProcessWire - Job Modul

== Beispiel Setting für Jobs mit strukturierten Daten ==
Beispiel von SPPS

=== Job Template ===

==== Felder ====
<pre>
{
"job_addresscountry": {
"id": 191,
"name": "job_addresscountry",
"label": "Land",
"flags": 0,
"type": "FieldtypeText",
"textformatters": [
"TextformatterEntities"
],
"minlength": 0,
"maxlength": 2048,
"showCount": 0,
"size": 0,
"collapsed": 0,
"inputfieldClass": "",
"showIf": "",
"themeInputSize": "",
"themeInputWidth": "",
"themeOffset": "",
"themeBorder": "",
"themeColor": "",
"themeBlank": "",
"columnWidth": 100,
"required": "",
"requiredAttr": "",
"requiredIf": "",
"stripTags": "",
"placeholder": "",
"pattern": ""
},
"job_addresslocality": {
"id": 188,
"name": "job_addresslocality",
"label": "Ort",
"flags": 0,
"type": "FieldtypeText",
"textformatters": [
"TextformatterEntities"
],
"minlength": 0,
"maxlength": 2048,
"showCount": 0,
"size": 0,
"collapsed": 0,
"inputfieldClass": "",
"showIf": "",
"themeInputSize": "",
"themeInputWidth": "",
"themeOffset": "",
"themeBorder": "",
"themeColor": "",
"themeBlank": "",
"columnWidth": 100,
"required": "",
"requiredAttr": "",
"requiredIf": "",
"stripTags": "",
"placeholder": "",
"pattern": ""
},
"job_addressregion": {
"id": 189,
"name": "job_addressregion",
"label": "Job Region",
"flags": 0,
"type": "FieldtypeText",
"textformatters": [
"TextformatterEntities"
],
"minlength": 0,
"maxlength": 2048,
"showCount": 0,
"size": 0,
"collapsed": 0,
"inputfieldClass": "",
"showIf": "",
"themeInputSize": "",
"themeInputWidth": "",
"themeOffset": "",
"themeBorder": "",
"themeColor": "",
"themeBlank": "",
"columnWidth": 100,
"required": "",
"requiredAttr": "",
"requiredIf": "",
"stripTags": "",
"placeholder": "",
"pattern": ""
},
"job_basesalary_maxvalue": {
"id": 185,
"name": "job_basesalary_maxvalue",
"label": "job_basesalary_maxvalue",
"flags": 0,
"type": "FieldtypeInteger",
"zeroNotEmpty": 0,
"columnWidth": 33,
"inputType": "text",
"size": 10,
"collapsed": 0,
"defaultValue": "",
"showIf": "",
"themeOffset": "",
"themeBorder": "",
"themeColor": "",
"required": "",
"requiredIf": "",
"min": "",
"max": ""
},
"job_basesalary_minvalue": {
"id": 184,
"name": "job_basesalary_minvalue",
"label": "job_basesalary_minvalue",
"flags": 0,
"type": "FieldtypeInteger",
"zeroNotEmpty": 0,
"collapsed": 0,
"columnWidth": 33,
"inputType": "text",
"size": 10,
"defaultValue": "",
"showIf": "",
"themeOffset": "",
"themeBorder": "",
"themeColor": "",
"required": "",
"requiredIf": "",
"min": "",
"max": ""
},
"job_basesalary_unittext": {
"id": 186,
"name": "job_basesalary_unittext",
"label": "Bezahlung pro",
"flags": 0,
"type": "FieldtypeOptions",
"inputfieldClass": "InputfieldSelect",
"collapsed": 0,
"columnWidth": 33,
"initValue": "",
"showIf": "",
"themeInputSize": "",
"themeInputWidth": "",
"themeOffset": "",
"themeBorder": "",
"themeColor": "",
"required": "",
"requiredIf": "",
"defaultValue": "",
"export_options": {
"default": "1=MONTH|Monat\n2=YEAR|Jahr\n3=HOUR|Stunde\n4=WEEK|Woche\n5=DAY|Tag"
}
},
"job_dateposted": {
"id": 179,
"name": "job_dateposted",
"label": "Job Datum",
"flags": 0,
"type": "FieldtypeDatetime",
"collapsed": 0,
"inputType": "text",
"htmlType": "date",
"dateSelectFormat": "yMd",
"yearFrom": 1922,
"yearTo": 2042,
"yearLock": 0,
"datepicker": 3,
"timeInputSelect": 0,
"dateInputFormat": "Y-m-d",
"size": 25,
"columnWidth": 25,
"notes": "Datum des Postings",
"defaultToday": 1,
"dateOutputFormat": "",
"showIf": "",
"themeOffset": "",
"themeBorder": "",
"themeColor": "",
"required": "",
"requiredAttr": "",
"requiredIf": "",
"dateMin": "",
"dateMax": "",
"timeStep": "",
"timeMin": "",
"timeMax": "",
"timeInputFormat": "",
"placeholder": "",
"yearRange": ""
},
"job_description": {
"id": 181,
"name": "job_description",
"label": "job_description",
"flags": 0,
"type": "FieldtypeTextareaLanguage",
"inputfieldClass": "InputfieldCKEditor",
"contentType": 1,
"minlength": 0,
"maxlength": 0,
"showCount": 0,
"rows": 5,
"textformatters": [
"TextformatterHannaCode"
],
"htmlOptions": [
2,
4,
16
],
"langBlankInherit": 0,
"collapsed": 0,
"toolbar": "Format, Styles, -, Bold, Italic, -, RemoveFormat\nNumberedList, BulletedList, -, Blockquote\nPWLink, Unlink, Anchor\nPWImage, Table, HorizontalRule, SpecialChar\nPasteText, PasteFromWord\nScayt, -, Sourcedialog\nJustifyCenter, JustifyLeft, JustifyRight",
"inlineMode": 0,
"useACF": 1,
"usePurifier": 1,
"formatTags": "p;h1;h2;h3;h4;h5;h6;pre;address",
"contentsCss": "/site/templates/modules/InputfieldCKEditor/contents.css",
"stylesSet": "customstyles:/site/templates/modules/InputfieldCKEditor/mystyles.js",
"extraPlugins": [
"pwimage",
"pwlink",
"sourcedialog"
],
"removePlugins": "image,magicline",
"showIf": "",
"themeOffset": "",
"themeBorder": "",
"themeColor": "",
"columnWidth": 100,
"required": "",
"requiredAttr": "",
"requiredIf": "",
"imageFields": "",
"toggles": "",
"extraAllowedContent": "",
"contentsInlineCss": "",
"customOptions": "",
"plugin_sourcedialog": ""
},
"job_employmenttype": {
"id": 192,
"name": "job_employmenttype",
"label": "Art der Anstellung",
"flags": 0,
"type": "FieldtypeOptions",
"inputfieldClass": "InputfieldSelect",
"collapsed": 0,
"initValue": "",
"showIf": "",
"themeInputSize": "",
"themeInputWidth": "",
"themeOffset": "",
"themeBorder": "",
"themeColor": "",
"columnWidth": 100,
"required": "",
"requiredIf": "",
"defaultValue": "",
"export_options": {
"default": "1=FULL_TIME|Vollzeit\n2=PART_TIME|Teilzeit\n3=CONTRACTOR|Vertrag\n4=TEMPORARY|Zeitarbeit\n5=INTERN|Internship (Trainee etc.)\n6=VOLUNTEER|Volontariat\n7=PER_DIEM|Per diem\n8=OTHER|Andere"
}
},
"job_link": {
"id": 178,
"name": "job_link",
"label": "Link zum Jobangebot",
"flags": 0,
"type": "FieldtypeURL",
"textformatters": [
"TextformatterEntities"
],
"noRelative": 0,
"allowIDN": 0,
"allowQuotes": 0,
"addRoot": 0,
"collapsed": 0,
"minlength": 0,
"maxlength": 1024,
"showCount": 0,
"size": 0,
"showIf": "",
"themeInputSize": "",
"themeInputWidth": "",
"themeOffset": "",
"themeBorder": "",
"themeColor": "",
"themeBlank": "",
"columnWidth": 100,
"required": "",
"requiredAttr": "",
"requiredIf": "",
"placeholder": "",
"pattern": ""
},
"job_logo": {
"id": 183,
"name": "job_logo",
"label": "Logo",
"flags": 0,
"type": "FieldtypeImage",
"fileSchema": 270,
"textformatters": [
"TextformatterEntities"
],
"extensions": "gif jpg jpeg png",
"maxFiles": 0,
"outputFormat": 2,
"descriptionRows": 1,
"useTags": 0,
"gridMode": "grid",
"focusMode": "on",
"resizeServer": 0,
"clientQuality": 90,
"maxReject": "",
"dimensionsByAspectRatio": "",
"defaultValuePage": "",
"inputfieldClass": "InputfieldImage",
"notes": "optional",
"collapsed": 0,
"outputString": "",
"noLang": "",
"entityEncode": "",
"tagsList": "",
"showIf": "",
"themeOffset": "",
"themeBorder": "",
"themeColor": "",
"columnWidth": 100,
"required": "",
"requiredIf": "",
"unzip": "",
"overwrite": "",
"maxWidth": "",
"maxHeight": "",
"maxSize": "",
"minWidth": "",
"minHeight": "",
"aspect_ratios": ""
},
"job_organizationname": {
"id": 193,
"name": "job_organizationname",
"label": "Name der Organisation",
"flags": 0,
"type": "FieldtypeOptions",
"inputfieldClass": "InputfieldSelect",
"collapsed": 0,
"initValue": "",
"showIf": "",
"themeInputSize": "",
"themeInputWidth": "",
"themeOffset": "",
"themeBorder": "",
"themeColor": "",
"columnWidth": 100,
"required": "",
"requiredIf": "",
"defaultValue": "",
"export_options": {
"default": "1=intensiv|SPPS Karlsruhe Intensiv\n2=karlsruhe|SPPS Karlsruhe\n3=rastatt|SPPS Ötigheim/Rastatt\n4=pforzheim|SPPS Pforzheim\n5=rheinhausen|SPPS Rheinhausen-Oberhausen\n6=tagespflege|Tagespflege Etje"
}
},
"job_organizationname_old": {
"id": 182,
"name": "job_organizationname_old",
"label": "Name der Organisation",
"flags": 0,
"type": "FieldtypeText",
"collapsed": 0,
"minlength": 0,
"maxlength": 2048,
"showCount": 0,
"size": 0,
"textformatters": "",
"inputfieldClass": "",
"showIf": "",
"themeInputSize": "",
"themeInputWidth": "",
"themeOffset": "",
"themeBorder": "",
"themeColor": "",
"themeBlank": "",
"columnWidth": 100,
"required": "",
"requiredAttr": "",
"requiredIf": "",
"stripTags": "",
"placeholder": "",
"pattern": ""
},
"job_postalcode": {
"id": 190,
"name": "job_postalcode",
"label": "PLZ",
"flags": 0,
"type": "FieldtypeText",
"textformatters": [
"TextformatterEntities"
],
"minlength": 0,
"maxlength": 2048,
"showCount": 0,
"size": 0,
"collapsed": 0,
"inputfieldClass": "",
"showIf": "",
"themeInputSize": "",
"themeInputWidth": "",
"themeOffset": "",
"themeBorder": "",
"themeColor": "",
"themeBlank": "",
"columnWidth": 100,
"required": "",
"requiredAttr": "",
"requiredIf": "",
"stripTags": "",
"placeholder": "",
"pattern": ""
},
"job_streetaddress": {
"id": 187,
"name": "job_streetaddress",
"label": "Adresse",
"flags": 0,
"type": "FieldtypeText",
"textformatters": [
"TextformatterEntities"
],
"collapsed": 0,
"minlength": 0,
"maxlength": 2048,
"showCount": 0,
"size": 0,
"inputfieldClass": "",
"showIf": "",
"themeInputSize": "",
"themeInputWidth": "",
"themeOffset": "",
"themeBorder": "",
"themeColor": "",
"themeBlank": "",
"columnWidth": 100,
"required": "",
"requiredAttr": "",
"requiredIf": "",
"stripTags": "",
"placeholder": "",
"pattern": ""
},
"job_validthrough": {
"id": 180,
"name": "job_validthrough",
"label": "Gültig bis",
"flags": 0,
"type": "FieldtypeDatetime",
"inputType": "text",
"htmlType": "date",
"dateSelectFormat": "yMd",
"yearFrom": 1922,
"yearTo": 2042,
"yearLock": 0,
"datepicker": 3,
"timeInputSelect": 0,
"dateInputFormat": "Y-m-d",
"size": 25,
"columnWidth": 25,
"collapsed": 0,
"dateOutputFormat": "",
"showIf": "",
"themeOffset": "",
"themeBorder": "",
"themeColor": "",
"required": "",
"requiredAttr": "",
"requiredIf": "",
"dateMin": "",
"dateMax": "",
"timeStep": "",
"timeMin": "",
"timeMax": "",
"timeInputFormat": "",
"placeholder": "",
"yearRange": "",
"defaultToday": ""
}
}
</pre>
Options für:

'''job_basesalary_unittext'''
<pre>
1=MONTH|Monat
2=YEAR|Jahr
3=HOUR|Stunde
4=WEEK|Woche
5=DAY|Tag
</pre>

'''job_employmenttype'''
<pre>
1=FULL_TIME|Vollzeit
2=PART_TIME|Teilzeit
3=CONTRACTOR|Vertrag
4=TEMPORARY|Zeitarbeit
5=INTERN|Internship (Trainee etc.)
6=VOLUNTEER|Volontariat
7=PER_DIEM|Per diem
8=OTHER|Andere
</pre>

'''job_organizationname'''
<pre>
kann genutzt werden wenn man mehrere Organisationen hat
</pre>

'''Job Fieldset Page'''

Das Feld fasst die anderen Felder in eines zusammen. So kann man sie einfacher handeln.
<pre>
{
"job": {
"id": 177,
"name": "job",
"label": "Job",
"flags": 0,
"type": "FieldtypeFieldsetPage",
"notes": "Daten für ein Jobposting",
"icon": "wrench",
"template_id": 0,
"parent_id": 0,
"repeaterLoading": 2,
"repeaterMaxItems": 1,
"repeaterMinItems": 1,
"collapsed": 0,
"repeaterFields": [
"job_dateposted",
"job_validthrough",
"job_organizationname",
"job_description",
"job_basesalary_minvalue",
"job_basesalary_maxvalue",
"job_basesalary_unittext",
"job_streetaddress",
"job_postalcode",
"job_addresslocality",
"job_addressregion",
"job_addresscountry",
"job_employmenttype",
"job_link",
"job_logo"
],
"showIf": "",
"themeOffset": "",
"themeBorder": "",
"themeColor": "",
"columnWidth": 100,
"required": "",
"requiredIf": "",
"fieldContexts": {
"job_dateposted": {
"icon": "calendar",
"notes": "Datum des Postings. Wenn leer wird das Erstelldatum dieser Seite verwendet."
},
"job_validthrough": {
"icon": "calendar",
"notes": "Empfohlen. Unbefristet für manche Berufsgruppen erlaubt (z.B. Bedienungen)"
},
"job_organizationname": [],
"job_description": [],
"job_basesalary_minvalue": [],
"job_basesalary_maxvalue": [],
"job_basesalary_unittext": [],
"job_streetaddress": [],
"job_postalcode": [],
"job_addresslocality": [],
"job_addressregion": [],
"job_addresscountry": [],
"job_employmenttype": [],
"job_link": {
"notes": "Wenn leer wird diese Seite genutzt."
},
"job_logo": []
}
}
}
</pre>

==== Templates Import ====
Import Daten (Zulässige Kind/Elternseiten von Hand nachtragen)
<pre>
{
"job": {
"id": 53,
"name": "job",
"fieldgroups_id": "job",
"flags": 0,
"cache_time": 0,
"useRoles": 1,
"editRoles": [],
"addRoles": [],
"createRoles": [],
"rolesPermissions": [],
"noInherit": 0,
"childrenTemplatesID": 0,
"sortfield": "",
"noChildren": 1,
"noParents": "",
"childTemplates": [],
"parentTemplates": [
"jobs"
],
"allowPageNum": 0,
"allowChangeUser": 0,
"redirectLogin": 0,
"urlSegments": 0,
"https": 0,
"slashUrls": 1,
"slashPageNum": 0,
"slashUrlSegments": 0,
"altFilename": "",
"guestSearchable": 0,
"pageClass": "",
"childNameFormat": "",
"pageLabelField": "fa-user-circle-o title",
"noGlobal": 0,
"noMove": 0,
"noTrash": 0,
"noSettings": 0,
"noChangeTemplate": 0,
"noShortcut": 0,
"noUnpublish": 0,
"noLang": 0,
"compile": 3,
"nameContentTab": 0,
"noCacheGetVars": "",
"noCachePostVars": "",
"useCacheForUsers": 0,
"cacheExpire": 0,
"cacheExpirePages": [],
"cacheExpireSelector": "",
"label": "Stellenangebot",
"tags": "",
"titleNames": 0,
"noPrependTemplateFile": 0,
"noAppendTemplateFile": 0,
"prependFile": "",
"appendFile": "",
"pagefileSecure": 0,
"tabContent": "",
"tabChildren": "",
"nameLabel": "",
"contentType": "",
"errorAction": 0,
"connectedFieldID": null,
"ns": "ProcessWire",
"_exportMode": true,
"roles": [
"guest"
],
"fieldgroupFields": [
"title",
"layout_blocks",
"job"
],
"fieldgroupContexts": {
"title": [],
"layout_blocks": [],
"job": []
}
},
"jobs": {
"id": 55,
"name": "jobs",
"fieldgroups_id": "jobs",
"flags": 0,
"cache_time": 0,
"useRoles": 1,
"editRoles": [],
"addRoles": [],
"createRoles": [],
"rolesPermissions": [],
"noInherit": 0,
"childrenTemplatesID": 0,
"sortfield": "",
"noChildren": "",
"noParents": -1,
"childTemplates": [
"job"
],
"parentTemplates": [],
"allowPageNum": 1,
"allowChangeUser": 0,
"redirectLogin": 0,
"urlSegments": 0,
"https": 0,
"slashUrls": 1,
"slashPageNum": 0,
"slashUrlSegments": 0,
"altFilename": "",
"guestSearchable": 0,
"pageClass": "",
"childNameFormat": "",
"pageLabelField": "fa-users title",
"noGlobal": 0,
"noMove": 0,
"noTrash": 0,
"noSettings": 0,
"noChangeTemplate": 0,
"noShortcut": 0,
"noUnpublish": 0,
"noLang": 0,
"compile": 3,
"nameContentTab": 0,
"noCacheGetVars": "",
"noCachePostVars": "",
"useCacheForUsers": 0,
"cacheExpire": 0,
"cacheExpirePages": [],
"cacheExpireSelector": "",
"label": "Stellenangebote",
"tags": "",
"titleNames": 0,
"noPrependTemplateFile": 0,
"noAppendTemplateFile": 0,
"prependFile": "",
"appendFile": "",
"pagefileSecure": 0,
"tabContent": "",
"tabChildren": "",
"nameLabel": "",
"contentType": "",
"errorAction": 0,
"connectedFieldID": null,
"ns": "ProcessWire",
"_exportMode": true,
"roles": [
"guest"
],
"fieldgroupFields": [
"title",
"layout_blocks",
"images",
"files",
"menu"
],
"fieldgroupContexts": {
"title": [],
"layout_blocks": [],
"images": [],
"files": [],
"menu": []
}
}
}
</pre>

=== Template Jobs ===
Todo besser als Layout-Block
<syntaxhighlight lang="php">
// JOBLIST
$joblist = '';
$jobs = pages('template=job,sort=-published');
foreach ($jobs as $item) {
$joblist .= '<li class="joblist-item"><a href="'.$item->url.'">'.$item->title.' ('.$item->job->job_organizationname->title.')</a></div>';
}
$joblist = '<ul class="joblist">'.$joblist.'</ul>';
</syntaxhighlight>
=== Template Job ===
Benötigt im Admin Bereich nur das job Feld. In diesem sind alle anderen benötigten Felder bereits enthalten.

<syntaxhighlight lang="php">
<?php namespace ProcessWire;
include_once('includes/SchemaHelper.php');
$sh = new SchemaHelper;
$jsonld = $sh->jsonldJobPosting($page);

// BEWERBUNGSFORMULAR WENN GESÜNSCHT
$contact = $forms->render('bewerbung');

ob_start();
?>

<div class="container">
<div id="apply">
<h1><?=$page->title?></h1>
<div class="job-description">
<?=$page->job->job_description?>
</div>
<div class="">Arbeitgeber</div>
<?=$page->job->job_organizationname->title?><br>
<?=$page->link?>
</div>
<div class="font-heavy">Arbeitsort</div>
<?=$page->job->job_streetaddress?><br>
<?=$page->job->job_postalcode?> <?=$page->job->job_addresslocality?>
</div>
<?php if ($page->job->job_basesalary_minvalue && $page->job->job_basesalary_maxvalue && $page->job->job_basesalary_unittext): ?>
<div class="font-heavy">Vergütung</div>
<div><?=$page->job->job_basesalary_minvalue?>€ - <?=$page->job->job_basesalary_maxvalue?>€ <?=$page->job->job_basesalary_unittext->title?></div>
<?php elseif($page->job->job_basesalary_minvalue && $page->job->job_basesalary_unittext): ?>
<div class="font-heavy">Vergütung</div>
<div><?=$page->job->job_basesalary_minvalue?>€ <?=$page->unit->title?></div>
<?php endif ?>
<div class="font-heavy pt-20">Art der Anstellung</div>
<div class="pb-30"><?=$page->job->job_employmenttype->title?></div>
</div>

<div id="apply-form" class="">
<h2>Bewerbung</h2>
<div><?= $contact ?></div>
</div>

<?=$jsonld?>
</div>
<?php

$content = ob_get_clean();
</syntaxhighlight>

=== Bewerbungsformular ===
<pre>
{
"required": false,
"columnWidth": 0,
"roles": {
"form-submit": [
"guest"
],
"form-list": [],
"form-edit": [],
"form-delete": [],
"entries-list": [],
"entries-edit": [],
"entries-delete": [],
"entries-page": [],
"entries-resend": []
},
"flags": 256,
"pluginActions": [],
"framework": "Uikit3",
"allowPreset": 0,
"skipSessionKey": 0,
"useCookies": 0,
"partialEntryDays": 14,
"spamEntryDays": 7,
"submitText": "Absenden",
"successMessage": "Vielen Dank - Ihre Bewerbung wurde versendet.",
"errorMessage": "Ein Fehler ist aufgetreten. Bitte überprüfen Sie Ihre Eingaben.",
"mobilePx": 0,
"frBasic_noLoad": [],
"frBasic_cssURL": "/site/modules/FormBuilder/frameworks/basic/main.css",
"frBasic_itemContent": [
"description",
"out",
"error",
"notes"
],
"spamFlags": 0,
"listFields": [],
"entryDays": 0,
"emailSubject": "Bewerbungsformular auf salus-klinik.de",
"responderSubject": "Auto-Response",
"saveFlags": 35,
"spamWords": [],
"honeypot": "name_1",
"emailTo": "post@stephanschlegel.de",
"frUikit3_noLoad": [
"framework",
"jquery",
"jqueryui"
],
"frUikit3_ukURL": "/site/modules/FormBuilder/frameworks/uikit3/",
"frUikit3_css": "uikit.min.css",
"frUikit3_horizontal": "0",
"frUikit3_inlineErrorBelow": "1",
"frUikit3_horizHeaderWidth": 30,
"frUikit3_buttonType": "primary",
"children": {
"name_1": {
"type": "Text",
"label": "Name",
"required": false,
"columnWidth": 0,
"collapsed": "0",
"minlength": 0,
"maxlength": 2048,
"showCount": "0",
"size": 0
},
"name_2": {
"type": "Text",
"label": "Name",
"required": 1,
"columnWidth": 0,
"collapsed": "0",
"minlength": 0,
"maxlength": 2048,
"showCount": "0",
"size": 0
},
"e_mail": {
"type": "Email",
"label": "E-Mail",
"required": 1,
"columnWidth": 0,
"collapsed": "0",
"minlength": 0,
"maxlength": 250,
"showCount": "0",
"size": 0
},
"telefon": {
"type": "Text",
"label": "Telefon",
"required": 1,
"columnWidth": 0,
"collapsed": "0",
"minlength": 0,
"maxlength": 2048,
"showCount": "0",
"size": 0
},
"bewerbungsunterlagen": {
"type": "FormBuilderFile",
"label": "Bewerbungsunterlagen",
"notes": "Maximal 3 Dateien á 5MB",
"required": false,
"columnWidth": 0,
"collapsed": "0",
"extensions": "pdf doc docx xls xlsx gif jpg jpeg png",
"maxFiles": 3,
"maxFileSize": 5242880
}
}
}
</pre>
=== Layout Block - Job-Liste ===
Beispiel Salus
<syntaxhighlight lang="php">
<?php namespace ProcessWire;
$sectionClasses = array($page->_type);
$containerClasses = array('ani section');
if($page->bg && $page->bg->value) {
$colorClassBorder = $page->bg->value;
$colorClassContent = $page->bg->value;
}
else {
$colorClassBorder = 'bc1';
$colorClassContent = 'bc1';
}

$out = '';
$jobsMarkup = '';
$jobsAccordion = new Box;
$jobs = pages('template=job,sort=-published');
foreach ($jobs as $item) {

$jobsMarkup .= '
<li class="bc1 joblist-item">
<a class="uk-accordion-title uk-padding-small" href="#">
'.$item->title.'
</a>
<div class="uk-accordion-content uk-padding-small nmt npt">
<p><strong>'.$item->job->job_organizationname->title.'</strong></p>
<p><strong>Arbeitsort:</strong> '.$item->job->job_addresslocality.'<br>
<strong>Art der Anstellung: </strong>'.$item->job->job_employmenttype->title.'</p>
<p><a class="uk-button uk-button-primary" href="'.$item->url.'">Zur Stellenbeschreibung</a></p>
</div>
</li>
';
}

$jobsAccordion->addClasses('accordion uk-accordion nmb');
$jobsAccordion->addAttributes('uk-accordion=""'); // i.e. active:0
$out .= $jobsAccordion->wrap($jobsMarkup,'ul');

// RANDSPALTE?
$out = '
<div class="uk-grid uk-grid-collapse uk-grid-match" uk-grid>
<div class="uk-visible@m uk-width-1-5 '.$colorClassBorder.'">
<div class="uk-padding-small">
</div>
</div>

<div class="uk-width-expand@m">
<div class="uk-padding npt npb npr">
'.renderHeadline($page).'
'. $out .'
</div>
</div>
</div>
';
//$out = renderContainer($page,$out,$containerClasses);
$out = renderSection($page,$out,$sectionClasses,array('skipDefaultClasses'=>false));
return $out;

</syntaxhighlight>
=== Funktionalität ===
==== SchemaHelper ====
Für Erzeugung der Strukturierten Daten

<syntaxhighlight lang="php">
<?php namespace ProcessWire;
/**
* SchemaHelper
* Class for structured data
* V1.0
*/
// @todo outsource some of the nessecary types (i.e. place) in backend use
// fieldgroups for that maybe s.th. like $place = getFg('schema_place')
class SchemaHelper{
// Load the requested schema from the schemas directory and register the class
public function jsonldJobPosting ($p) {
$jsonld = array();
$sanitizer = wire('sanitizer');
//set unset fields (for not mandatory fields)
$p->job->job_validthrough = $p->job->job_validthrough ? : ''; // todo test

$jsonld["@context"] = "http://schema.org/";
$jsonld["@type"] = "JobPosting";
if($p->job->job_link) $jsonld["url"] = $p->job->job_link;
else $jsonld["url"] = $sanitizer->url($p->httpUrl);
$jsonld["datePosted"] = !empty($p->job->job_dateposted) ? date('Y-m-d', $p->job->getUnformatted('job_dateposted') ) : date('Y-m-d', strtotime($p->created));
$jsonld["validThrough"] = date('Y-m-d', $p->job->getUnformatted('job_validthrough') );
$jsonld["description"] = $sanitizer->textarea($p->job->job_description);
$jsonld['hiringOrganization'] = array(
"@type" => "Organization",
"name" => $sanitizer->text($p->job->job_organizationname->title),
"sameAs" => $sanitizer->url($p->job->job_link)
);
if($p->job->link2)$jsonld['hiringOrganization']['logo'] = $p->job->link2;
$jsonld['title'] = $sanitizer->text($p->title);

if($p->job->job_basesalary_minvalue && $p->job->job_basesalary_maxvalue && $p->job->job_basesalary_unittext){
$jsonld['baseSalary'] = array(
"@type" => "MonetaryAmount",
"currency" => "EUR",
"value" => array(
"@type" => "QuantitativeValue",
"minValue" => $sanitizer->float($p->job->job_basesalary_minvalue),
"maxValue" => $sanitizer->float($p->job->job_basesalary_maxvalue),
"unitText" => $sanitizer->text($p->job->job_basesalary_unittext->value)
)
);
}else if($p->job->job_basesalary_minvalue && $p->job->job_basesalary_unittext){
$jsonld['baseSalary'] = array(
"@type" => "MonetaryAmount",
"currency" => "EUR",
"value" => array(
"@type" => "QuantitativeValue",
"value" => $sanitizer->float($p->job->job_basesalary_minvalue),
"unitText" => $sanitizer->text($p->job->job_basesalary_unittext->value)
)
);
}
$jsonld['jobLocation'] = array(
"@type" => "Place",
"address" => array(
"@type" => "PostalAddress",
"streetAddress" => $sanitizer->text($p->job->job_streetaddress),
"addressLocality" => $sanitizer->text($p->job->job_addresslocality),
"addressRegion" => $sanitizer->text($p->job->job_addressregion),
"postalCode" => $sanitizer->text($p->job->job_postalcode),
"addressCountry" => $sanitizer->text($p->job->job_addresscountry),
)
);
// recommended properties

if($c = count($p->job->job_employmenttype)){
$types = array();
foreach($p->job->job_employmenttype as $type){
$types[] = $sanitizer->text($type->value);
}
//var_dump($c);
if($c > 1) $jsonld['employmentType'] = $types;
else $jsonld['employmentType'] = $types[0];
}

//$out .= '<script type="application/ld+json">' . json_encode($jsonld) . '</script>';
$out = '<script type="application/ld+json">' . json_encode($jsonld,JSON_PRETTY_PRINT) . '</script>';

return $out;
}

}

</syntaxhighlight>

3D-Druck

2025-12-11T08:06:02Z

109.193.152.88: /* Filamente */

== Links ==
[[3D-Drucker kalibrieren und einstellen]]
[[3D-Drucker - Düse wechseln / reinigen]]
[[Cura]]

== Filamente ==
=== PLA ===
Temperatur: 180-220°C
Bett Temperatur: 30-50°C
Kühlung: 100%
Print speed: 40-60mm/s
PLA trocken halten

==== Sunlu PLA Wood ====
<pre>
[Wood-like Texture] Experience stronger wood-like texture and faster printing with the improved Wood PLA filament.
[15% Real Wood Powder] Contains 15% wood powder, delivering a natural wood scent during printing and results that closely resemble real wood.

Diameter: 1.75/3.0MM±0.03MM
Printing temperature:
195-205℃ 50-100mm/s
205-215℃ 100-150mm/s
215-260℃ 150-400mm/s
Bed temperature: not heated with glue, heated 60-65 ℃ can not be coated with glue
Bubble: 100% zero bubble
Net weight: 1KG/roll
Gross weight: 1.3KG/roll
Length: 1.75MM(1KG)≈330M
</pre>

=== PETG ===
https://3dprinterly.com/filament-printing-guide/petg/ guter Guide, Einstellungen, Gesundheit, Eigenschaften...

Print speed 30 - 60mm/s
Retraction 35-40mm/s Bowden and Direct Drive extruders
Retraction distance
5-7mm for Bowden extruders
2-4mm for direct-drive extruders
Fan-Speed niedrig für gute Layerhaftung, höher für Sauberkeit.

Retraction settings for PETG are very different from those for other filaments. This is because PETG prints at a relatively high temperature so, the material flow is very hard to stop and control.

'''Best Cura PETG Settings'''

Nozzle Temperature: 235-250°C
Bed Temperature: 70-100°C
Print Speed: 40-60mm/s
Initial Layer Print Speed: 20mm/s
Retraction Distance: 6mm (Bowden setups), 2-3mm (direct drive setups)
Retraction Speed: 40-45mm/s
Combing: “Not in Skin” or “Within Infill”
Cooling Fan Speed: 0-50% for strength, 50-100% for quality
Initial Layer Cooling Speed: 0%
Build Plate Adhesion: Raft or Brim

==== Ender 5 Pro - PETG Settings mit Bowden Tube ====
https://www.youtube.com/watch?v=aOA2hGMVp9w
Mal testen - sieht sinnvoll aus:
<pre>
Wichtige mit *
1.2mm Walls
Otimize wall printing order - on
Alternate extra walls - on
Z-Seam
Alignment Sharpest corner / smart hiding
Top Bottom 1.2
Ironing wenn man möchte
Infill 20%
Triangles
Connect Infill Lines on
Overlap 50% - kommt mir viel vor
Extra Wall Count 1 oder mehr
* Print Temperature 240
* Plate 80
Flow je nach Ergebnis anpassen oder kalibrieren
Print Speed max 70 50 ist safe
Travel Speed 200
Initial speed 20mm/s
z hop 5mms
accelerating contol on

* Enable Retraction
* Retraction Distance 7mm
* Retraction Speed 25mm/s
* Combing Mode Within Infill
* Avoid Printed Parts on
Avoid Supports when travelling on
z-hop when retracted off
* Cooling off (um Nozzle zu schüthen

Support Structure dezent weil schwer zu entfernen
Tree
Touching Buildplate
Support Overhang Angle 50 ca
Pattern Lines
Line Count 1
Connect no
Density 1
Brim Width 4mm

Build Plate Adhesion
Je nach Modell

Experimental
* Infill Travel Optiization on
Enable Draft Shield off
* Coasting on
* Coasting Volume 0.064mm2
Fuzzy Skin off
Adaptive Layers off
* Enable Bridge Settings on
Wipe Nozzle Between Layers off

</pre>

==== Is PETG Filament Toxic & Safe to 3D Print Indoor? ====

No, PETG filament is non-toxic, and it can be printed safely indoors. Also, it doesn’t even emit any smell when it is printing. Just make sure your 3D printing area is well ventilated to avoid a buildup of nanoparticles in the air. These particles can cause eye and throat irritations.

==== Is PETG Heat and UV Resistant? What Temperature Can PETG Withstand? ====

PETG has decent heat resistance properties, especially when compared to most other filaments. It can resist temperatures up to its glass transition temperature, which is around 80-85⁰C. It handily beats out filaments like PLA in this respect, but it displays less heat resistance than ABS.

However, it is '''more UV resistant than both of them''', making it the perfect choice for outdoor applications.

=== TPU ===
[[3D-Druck TPU drucken]]

=== Infill Tipps ===
[[3D-Druck - Infill]]

3D-Drucker kalibrieren und einstellen

2025-12-03T16:49:57Z

109.193.152.88: /* Feintuning */

== Ablauf ==
Was kann man Einstellen und auf was hat es Einfluss?
* Laufwägen - Andruck der Rollen checken
* Motoren eSteps kalibrieren
** Achsen für Maßhaltigkeit (Calibration Cube)
** Extruder für Flow

== Bedleveling - Druckbett einstellen ==
https://drucktipps3d.de/bettleveling-bettleveling-und-immer-wieder-bettleveling/

* Bett vorheizen
* Autohome
* Stepper aus (außer z bei bettwewegern)
* links vorn, links hinten, rechts hinten, rechts vorn
* 2. Runde, Mitte
=== Feintuning ===
Feinausrichtung.

Der erste Layer entscheidet.

* Druckobjekt aus 5 Quadraten mit ca. 20mm Kantenlänge, Höhe 0,2mm (1 Layer)
* 4 Ecken und der Mitte anordnen.
* Im Slicer Skirt mit ca. 5 Linien hinzu
* Geschwindigkeit drastisch reduzieren (direkt im Drucker regeln z.B. 30%), dann kann man direkt reagieren und die Haftung ist gut.

Beim Druck des Skirt könnt Ihr optisch und mit dem Finger fühlen ob und wie die Plastewurst auf dem Druckbett haftet und könnt das Druckbett nachjustieren.
An den Quadraten bekommt Ihr das Ergebnis Eurer Bemühung. Eine saubere geschlossene Fläche ist das Ziel. Fehlerbilder für Düsenabstand und andere Druckprobleme findet Ihr mit Erklärung auf der Seite von Simplify 3D.

Wiederholt diesen Ausdruck bis das Ergebnis perfekt ist.

== Probleme und Lösungen ==

=== Stringing ===
* Feuchtes Filament
* Nozzle verschmuzt
* Retraction zu schwach oder/und zu schnell
* Kühlung falsch
* Bowdenzug hat viel Spiel
* Temperatur falsch (Heattower drucken)

=== Über- Unterextrudierung ===

=== Betthaftung ===
* Auflagefläche zu klein
* Nozzle zu weit weg (Druckbett leveln)
* Fett auf der Fläche
* Temperatur falsch (vor allem bei ABS etc wichtig)

== Tests ==

=== Flow Control / Fluss einstellen ===
Den Flow kann man in Cura einstellen.
Landen pro Schicht wirklich 0.4mm auf dem Bett, wenn 0.4mm eingestellt sind?
Abhängig haupsächlich von:
* Extruderkalibrierung => ERST MAL EXTRUDER RICHTIG KALIBRIEREN, DANN FLOW ALS FEINEINSTELLUNG FÜR FILAMENT ANPASSEN
* Filament - Wenn das dicker ist kommt mehr raus

==== Flow Tests ====
20mm Calibration Cube laden (Wandstärke 1 Schicht)

Cura:
Linienbreite 0.4mm, Wandanzahl: 1
Obere Untere Schichten 0 (nur Wände)
Infill keins
Flow steht auf 100%

Nach dem Drucken Wandstärke messen (am besten nur oben wg. Elefantenfüßen)

Soll-Wandstärke x 100 / IstWandstärke = Flow

z.B. 0.4 * 100 / 0.48 = 83,5

im Zweifel vlt. eher Aufrunden (Ungenauigkeiten, Hitze... tragen eher breiter auf)

=== Extruder Fördermenge kalibrieren / eSteps einstellen ===
'''Prinzip:'''

10cm fördern, tatsächliche Fördermenge messen

Neue Steps = Alte Steps / Tatsächlich geförderte Länge * gewünschte Länge
Neue Werte über Display oder über Terminalsoftware im Drucker speichern.

'''Details:'''
https://all3dp.com/de/2/extruder-kalibrierung-3d-drucker/

Du kannst die Messung und Speicherung der Werte entweder über das Druckermenü (zumindest bei aktuellen Druckern) oder über ein Terminal o.ä. machen. Das geht z.B. in Pronterface.

==== Messung und Berechnung in der Praxis ====
* eSteps auslesen
m503
* Düse vorheizen
* Material am Einzug und 12cm weiter hinten mit Stift markieren
* Extrusion resetten
M83
* 10cm Einziehen (Terminal oder im Menü der Bedieneinheit)
G1 E100 F100
* Schauen ob genau 2cm bis zur Markierung übrig sind. Wenn weniger hat er zuviel eingezogen, wenn mehr hat er zu wenig eingezogen.
* Neue Steps berechnen
Beispiel:
22,6mm übrig => Tatsächlich geförderte Menge ist 120mm - 22,6mm = 97,4
Alte Steps * gewünschte Länge / Tatsächlich geförderte Länge = Neue Steps
100 * 100 / 97,4mm = 102,669 => ca 102,67
* Neue eSteps setzen und speichern (Komma konnte man bei mir zweistellig angeben):
M92 E102.67
M500

==== Mit Pronterface verbinden und Drucker steuern ====

Bei mir auf dem Mac
tty.usbserial-14330 at baudrate 115200:
Seriell über usb sollte in der Regel mit tty.usbserial oder tty.usbmodem starten. Baudrate hat 115200 für den Ender 5 gepasst. Andere funktionierten nicht.

'''Die wichtigsten Befehle für Pronterface:'''
M83 = Extrusion auf 0 setzen (ist wohl so eine Art zwischenspeicher)

M503 = gespeicherte e Steps anzeigen lassen
Der Drucker gibt dann eine ganze Latte an Infos aus Wichtig für uns die Zeile die mit M92 beginnt oben sehen wir auch noch was eine unit bedeutet wir wissen also unser Extruder macht hier 100 Schritte pro mm:
<pre>
>>> m503
SENDING:M503
echo: G21 ; Units in mm (mm)
...
echo:Steps per unit:
echo: M92 X80.00 Y80.00 Z800.00 E100.00
...
</pre>
Am Ende sieht man am Wert E100.00 die Steps des Extruder pro Einheit (bei uns mm). Das sind die sogenannten ESteps

G1 E100 F50 = 10cm langsam fördern (G = Go / E Extrude / F = Fast )

M92 E(neue Steps) = neue e Steps im System hinterlegen (Punkte keine Kommas!)

M500 = neuen Wert in der Firmware speichern

https://www.pronterface.com/

'''Regeln'''

25%-75% Regel

ProcessWire - Hanna Code (Module)

2025-11-10T07:16:54Z

109.193.152.88:

TextformatterHannaCode

Easily insert any complex HTML, Javascript or PHP output in your ProcessWire content by creating your own Hanna code tags.
https://github.com/ryancramerdesign/ProcessHannaCode#using-hanna-code-from-the-api

== Hanna Code Snippets ==
=== find parent page ===
Sometime you need to find a parent page.
<syntaxhighlight lang="php">
if (!function_exists('getPage')) {

function getPage($myPage, $level=1){
// if in repeater or repeaterMatrix find the first parent ProcessWire\Page Page
$maxLevel=5;
if( get_class($myPage) == 'ProcessWire\RepeaterMatrixPage' || get_class($myPage) == 'ProcessWire\RepeaterPage') {
$level +=1;
if($level > $maxLevel) return false;
$forPage = $myPage->getForPage();
//var_dump( $myPage->getForPage());
//echo("<p>next Level: ".get_class($forPage)."</p>");
return $myPage = getImagePage($forPage);

}else if( get_class($myPage) == 'ProcessWire\Page'){

return $myPage;
}
}
}

</syntaxhighlight>

=== Image from RepeaterMatrix or Repeater ===
<syntaxhighlight lang="php">
<?php
// include a image from the parent page
if (!function_exists('getImagePage')) {

function getImagePage($myPage, $level=1){
// if in repeater or repeaterMatrix find the first parent ProcessWire\Page Page
$maxLevel=5;
if( get_class($myPage) == 'ProcessWire\RepeaterMatrixPage' || get_class($myPage) == 'ProcessWire\RepeaterPage') {
$level +=1;
if($level > $maxLevel) return false;
$forPage = $myPage->getForPage();
//var_dump( $myPage->getForPage());
//echo("<p>next Level: ".get_class($forPage)."</p>");
return $myPage = getImagePage($forPage);

}else if( get_class($myPage) == 'ProcessWire\Page'){

return $myPage;
}
}
}
$out = '';
$imagePage = getImagePage($page);
$images = $imagePage->images;
$imgTag = '';

if($images){
if(isset($file)){
isset($width) ? $image = $images->get($file)->width($width) : $image = $images->get($file);
$imgTag .= "<img src='$image->url'";
if(isset($width)) $imgTag .= " width='$width'";
if(isset($class)) $imgTag .= " class='$class'";
if(isset($style)) $imgTag .= " style='$style'";
$imgTag .= '>';
$out = $imgTag;
}else{
$out .= "<p>Gib einen Bildnamen an z.B.</p>";
foreach($images as $image){
$out .= '<p>[[image file="'.$image->name.'"]]</p>';
}
}
}else{
$out .= '<p>Keine Bilder auf der Seite gefunden</p>';

}
echo $out;
</syntaxhighlight>
=== Templates ===
<?php
echo(urls()->templates);

=== Video ===
Von chargercube - todo security / video field statt dateifeld
<syntaxhighlight lang="php">
<?php

// include a image from the parent page
if (!function_exists('getImagePage')) {

function getImagePage($myPage, $level=1){
// if in repeater or repeaterMatrix find the first parent ProcessWire\Page Page
$maxLevel=5;
if( get_class($myPage) == 'ProcessWire\RepeaterMatrixPage' || get_class($myPage) == 'ProcessWire\RepeaterPage') {
$level +=1;
if($level > $maxLevel) return false;
$forPage = $myPage->getForPage();
//var_dump( $myPage->getForPage());
//echo("<p>next Level: ".get_class($forPage)."</p>");
return $myPage = getImagePage($forPage);

}else if( get_class($myPage) == 'ProcessWire\Page'){

return $myPage;
}
}
}
$out = '';
$imagePage = getImagePage($page);
//var_dump($imagePage->name);
$files = $imagePage->files;
$videoTag = '';
$videoValid = false;
$styles = '';

if($files){
if(isset($file)){
$file = $files->get($file); // we need the file object not the file name
if(isset($width)) $styles = 'width: '.$width.'; max-width: 100%; height: auto;';
else $styles = 'width: 100%; height: auto;';
if($file){
$videoValid = true;
$videoTag .= '
<video style="'.$styles.'" preload="preload" playsinline="" controls="" uk-video="autoplay: false" aria-hidden="false">
<source src="'.$file->url.'" type="video/mp4">
Ihr Browser unterstützt kein Video Tag
</video>
';
$out = $videoTag;
}
}
if(!$videoValid){
$out .= "<p>Gib einen Dateinamen an. Dateien auf dieser Seite:.</p>";
foreach($files as $file){
$out .= '<p>[[video file="'.$file->name.'"]]</p>';
}
}
}else{
$out .= '<p>Keine Dateien auf der Seite gefunden</p>';
}

echo $out;

</syntaxhighlight>

=== Heading ===
Genbänkle

Attributes
tag=h2
heading
<pre>
<?php
echo($heading);
?>
</pre>

=== Next Events ===
Genbänkle
<syntaxhighlight lang="php">
<?php
$today = strtotime(date('Y-m-d'));
$eventPage = $pages->get('/termine/');
$mySelector = "template=event,limit=2,sort=event_date,event_date>=$today";
$events = $pages->find($mySelector);
$eventListMarkup = '';

foreach($events as $event){
$eventListMarkup .= '<div class="date uk-text-muted">'.$event->event_date.'</div>';
$eventListMarkup .= '<p><a href="'.$event->url().'">'.$event->title.'</a></p>';
}

echo $eventListMarkup;
</syntaxhighlight>

=== Childnavigation ===
<syntaxhighlight lang="php">
<?php namespace ProcessWire;
$out = '';
($attr['parent']) ? $parent = $pages->get($attr['parent']) : $parent = $page;
$children = $parent->children();
$out .= '<ul class="childnav">';
foreach ($children as $child){
$out .= '<li class="nav-item"><a class="nav-link" href="'.$child->url.'">'. $child->title . '</a></li>';
}
$out .= '</ul>';
echo $out;
</syntaxhighlight>

=== Social Media Icons über Repeater ===
<syntaxhighlight lang="php">
<?php namespace ProcessWire;

// SOCIALMEDIA
$socialmedia = '';
$p = $pages->get('/site-configuration/');
//bd($p->r_socialicons);
foreach($p->r_socialicons as $item){
if($item->link){
$socialmedia .= '<li><a href="'.$item->link.'" target="_blank" description="'.$item->text.'"><img src="'.$item->single_image->width(48)->url.'" uk-tooltip="'.$item->text.'" alt="'.$item->text.'" title="'.$item->text.'"></a></li>';
}
}

return '<ul class="nav socialicons uk-flex uk-flex-center@m nmb">'.$socialmedia.'</ul>';
</syntaxhighlight>

=== Content einer beliebigen Seite rendern ===
Hier am Beispiel einer Seite die Charts rendert (Template chart).
[[chart pageid=1234]]
<syntaxhighlight lang="php">
<?php namespace ProcessWire;
// if in repeater or repeaterMatrix find the first parent ProcessWire\Page Page
if (!function_exists('getParentPage')) {
function getParentPage($myPage, $level=1){
$maxLevel=3;
if( get_class($myPage) == 'ProcessWire\RepeaterMatrixPage' || get_class($myPage) == 'ProcessWire\RepeaterPage') {
$level +=1;
if($level > $maxLevel) return false;
$forPage = $myPage->getForPage();
//var_dump( $myPage->getParentPage());
//echo("<p>next Level: ".get_class($forPage)."</p>");
return $myPage = getParentPage($forPage);
}else if( get_class($myPage) == 'ProcessWire\Page'){
return $myPage;
}
}
}

$parent = getParentPage($page);
$parent->hasChart = true;
$chart = $pages->get($pageid); // this page contains our content. You should ommit appendFile in it's template because we don't want <head> etc.
$out ='';
$out .= $chart->render();

echo $out;
</syntaxhighlight>
=== Hanna Code an externe Funktion weitergeben ===
Wenn du die Hanna Formatierung für andere Dinge nutzen willst kannst du den Code auch einfach wieder ausgeben und dann die Seite selbst parsen. Wann das sinnvoll ist musst du selbst entscheiden...

'''Hanna code'''
<syntaxhighlight lang="php">
// Hanna code [[more]]:
<?php namespace ProcessWire;
// This tag is handled by template (readMore() Function in helpers.inc)
// so we just pass that tag through
echo('[[more]]');
</syntaxhighlight>

'''helpers.inc'''
<syntaxhighlight lang="php">
function readMore($text){
$readMore = __('Read more');
$readLess = __('Read less');
if($text){
$pos = strpos($text, '[[more]]', true);
if($pos){
$moreLink = '<div class="more-trigger" data-more="'.$readMore.'" data-less="'.$readLess.'">'.$readMore.'</div>';
$before = substr($text,0,$pos);
$after = substr($text,$pos+8);
return $before.'<div class="more-text" style="display:none;">'.$after.'</div>'.$moreLink;
}else return $text;
}
return $text;
}
</syntaxhighlight>

=== RepeaterMatrixItem von beliebiger Seite rendern ===
Hierbei gibt es ein paar Dinge zu beachten.

Im Backend wird der Hannacode Snippets in den Labels der Items angezeigt. Das kann das Backend zerhauen. Deshalb testen wir ob wir im Admin Bereich sind und geben etwas anderes aus. Außerdem möchten wir im Template auswergen ob es über Hanna aufgerufen wurde. Dann können wir z.B. Container weglassen, die eh schon über das Elternitem kommen.
<syntaxhighlight lang="php">
<?php namespace ProcessWire;
// shows a layoutblock from another page
// can give you a list of all available blocks on a page if you provide a page id
// @param id - Page Id of a Page or of a RepeaterMatrixPage

$out = '';
//$p = $pages->get(5725);
$p = $pages->get($id);
if( gettype($p) == 'object' ){
$class=get_class($p);
if($class == 'ProcessWire\RepeaterMatrixPage'){
// output
$currentPath = $_SERVER['REQUEST_URI'];
$isInAdminPage = (strpos($currentPath, '/processwire/') !== false);
if(!$isInAdminPage) $out .= $p->render();
else $out .= 'LAYOUTBLOCK VIA HANNA CODE';
}else if($class == 'ProcessWire\Page'){
// information
$out .= '<p>Gewählte Seite: '.$p->title.'</p>';
$out .= '<h4>Layout Blocks</h4>';
$out .= '<p>Du hast die Id einer Seite übergeben. Dieser Hanna Code benötigt die ID eines Layout Blocks. Die Seite enthält folgende Layout Blöcke verwenden:</p>';
$out .= '<ul>';
foreach($p->layout_blocks as $i => $item){
$out .= '<li>#'.($i+1).' [[layoutblock id='.$item->id.']] </li>';
}
$out .= '</ul>';
}else{
$out .= '<p class="uk-alert">Ungültige ID<p>';
}
}else{
$out .= '<p class="uk-alert">Die Id gehört zu keiner Seite.<p>';
}

echo $out;
</syntaxhighlight>

== Formbuilder und Hanna Code ==
Ist nicht ganz einfach, da der HannaCode mehrfach aufgerufen wird. Man kann das umgehen, indem man eine Variable beim ersten Call setzt und diese dann prüft bevor der Rest des Hanns Codes ausgeführt wird.

Typo3 - Update

2025-08-11T11:12:13Z

109.193.152.88: /* Prüfung in TYPO3 aussetzen */

== Links ==
http://wiki.typo3.org/Upgrade

[[TYPO3 - Troubleshooting Version 8]]
[[TYPO3 - Änderungen Version 9]]
== Aufräumen vor dem Update ==
http://typo3blogger.de/turchen-2-tutorial-typo3-entrumpeln/

=== Files ===
* kb_cleanfiles.
* Modul unter „DB-Überprüfung“ -> „Database Relations“. Neben dem Listing „Dateien, die in keinem Eintrag verwendet werden (bitte löschen!):“, welches der inhaltlichen Ausgabe der Extension sehr ähnelt, wird hier auch angezeigt ob Dateien doppelt referenziert werden
* typo3temp über install tool
=== Datenbank ===
* kj_recycler für papierkorb Daten danach refefence Index updaten
* cache_ Tabellen leeren
* sys_histroy leeren

Zur Not alles löschbar...

<pre>
[PHP]TRUNCATE TABLE sys_log //e.g. alle älter als 14 Tage
TRUNCATE TABLE sys_history //e.g. alle änderungen älter als 30 Tage

TRUNCATE TABLE index_fulltext
TRUNCATE TABLE index_grlist
TRUNCATE TABLE index_phash
TRUNCATE TABLE index_rel
TRUNCATE TABLE index_section
TRUNCATE TABLE index_stat_search
TRUNCATE TABLE index_stat_word
TRUNCATE TABLE index_words

TRUNCATE TABLE cache_pages
TRUNCATE TABLE cache_hash
TRUNCATE TABLE cache_imagesizes
TRUNCATE TABLE cache_pagesection
TRUNCATE TABLE cache_treelist
TRUNCATE TABLE cache_typo3temp_log
TRUNCATE TABLE cache_extensions

TRUNCATE TABLE tx_realurl_errorlog

TRUNCATE TABLE be_sessions
TRUNCATE TABLE fe_sessions
TRUNCATE TABLE fe_session_data[/PHP]

</pre>

== PHP Updates ==
=== PHP 5.5 2017 - Kurzanleitung ===
Kurzanleitung Update auf PHP 5.5 für TYPO3 4.5.x
<pre>
Wichtig
htaccess aktualisieren
Source aktualisieren
Umstellung utf8
- DB Export
- Textmate in utf-8 speichern
- Ersetzen von CHARSET=latin1 durch CHARSET=utf8
- Ersetzen der COLLATE
</pre>

localconf.php
=== PHP 5.6 2018 für TYPO 3 4.5 / 6.0===
Hinweis: 6.2 sollte laufen. Ältere Versionen sind ohnehin nicht mehr sicher.

Quelle:
http://www.typo3forum.net/discussion/79348/geloest-toolbaritem-shortcuts-must-implement-interface-backend-toolbaritem
https://www.typo3.net/forum/thematik/zeige/thema/123471/
Eine Suche im Netz ergab, dass T3 in der von mir verwendeten Version nicht mit PHP 5.6 kompatibel ist.

Unter diesem Link habe ich aber gefunden, wie man - bis zu einem Upgrade auf wenigstens 6.2 - das Backend wieder zum Laufen bekommt. Dazu müsste in folgenden Dateien über die Shell der Aufruf "&$backendReference" durch "$backendReference" ersetzt werden:

www/cms/typo3/classes/class.clearcachemenu.php:55:
www/cms/typo3/classes/class.livesearch.php:51:
www/cms/typo3/classes/class.shortcutmenu.php:79:
www/cms/typo3/interfaces/interface.backend_toolbaritem.php:43:
www/cms/typo3/sysext/opendocs/class.tx_opendocs.php:61:
www/cms/typo3/sysext/sys_action/toolbarmenu/class.tx_sysaction_toolbarmenu.php:53:
www/cms/typo3/sysext/sys_action/toolbarmenu/class.tx_sysaction_toolbarmenu.php:63:
www/cms/typo3/sysext/workspaces/Classes/BackendUserInterface/WorkspaceSelectorToolbarItem.php:59:

und zusätzlich noch

www/cms/typo3/classes/class.backendsearchmenu.php:52:
www/cms/typo3/classes/class.workspaceselector.php:57:
www/cms/typo3/sysext/workspaces/Classes/ExtDirect/WorkspaceSelectorToolbarItem.php:59

== Probleme lösen Version 7 ==
=== Update auf neuere Datenbanken Fehler: character set utf8 is not used for this connection ===
'''Potentielle Probleme:'''
* TYPO3 erwartet utf8 (genauer gesagt utf8mb3)
* TYPO3 7.6 geht standardmäßig von utf8_general_ci aus. Eine neuere Datenbank verwendet aber utf8mb3_general_ci – das ist funktional fast identisch mit dem alten utf8, aber durch neuere MySQL-Versionen expliziter gemacht. Trotzdem nicht 100 % dieselbe Bezeichnung → TYPO3 könnte das als Konflikt interpretieren.
* Verbindung läuft auf utf8mb4_unicode_ci Das ist ein 4-Byte-Zeichensatz, der nicht 100% kompatibel mit utf8mb3 ist. → Bei Sortierungen oder LIKE-Abfragen könnte TYPO3 falsche Ergebnisse bekommen (z. B. bei Umlauten, Emojis, Sonderzeichen). Ist aber i.d.R. nicht die Ursache für einen Datenbankfehler.
* Server-Default ist latin1_swedish_ci Dieser Zeichensatz ist alt und wird häufig von MySQL als Fallback verwendet. Gefährlich: Wenn irgendwo keine Zeichensatzangabe erfolgt (z. B. beim Import oder bei neuen Tabellen), wird automatisch latin1 genommen – und das zerstört Umlaute.

Lösungen:
==== Tabellen prüfen ====

== Update auf 7 ==
https://jweiland.net/video-anleitungen/typo3/typo3-projekte-verwalten/upgrade-typo3-62-auf-7.html
[[TYPO3 Update - 6 auf 7]]
https://jweiland.net/video-anleitungen/typo3/typo3-projekte-verwalten/typo3-7-lts-migration-von-css-styled-content-nach-fluid-styled-content.html
* css_styled_content wird durch fluid_styled_content ersetzt
* FSC bringt eigene CSS-Klassen für das Frontend mit. Anpassungen im CSS einer Website sind notwendig.
* Die Funktion "Rahmen und Einrückungen (section_frames)" gibt es nicht mehr. Hier muss bei Bedarf auf das "Layout"-Feld ausgewichen werden.
* Überschriften lassen sich nicht mehr direkt zentrieren oder rechts ausrichten.
* Die Bildeffekte (Drehung, Graustufen etc.) gibt es auch nicht mehr.

=== Fluid Styled Content ersetzt CSS Styled Content ===
[[TYPO3 - fluid_styled_content]]

=== htaccess für all-inkl TYPO3 v7===
So machts der Auto Installer:
<pre>
php_value always_populate_raw_post_data -1
php_value memory_limit 256M
php_value max_execution_time 240
<FilesMatch "\.(php.*|phtml)\.">
RewriteEngine on
RewriteRule .* - [R=403,L]
</FilesMatch>
#####
#
# Example .htaccess file for TYPO3 CMS - for use with Apache Webserver
#
# This file includes settings for the following configuration options:
#
# - Compression
# - Caching
# - MIME types
# - Cross Origin requests
# - Rewriting and Access
# - Miscellaneous
# - PHP optimisation
#
# If you want to use it, you have to copy it to the root folder of your TYPO3 installation (if its
# not there already) and rename it to '.htaccess'. To make .htaccess files work, you might need to
# adjust the 'AllowOverride' directive in your Apache configuration file.
#
# IMPORTANT: You may need to change this file depending on your TYPO3 installation!
# Consider adding this file's content to your webserver's configuration directly for speed improvement
#
# Lots of the options are taken from https://github.com/h5bp/html5-boilerplate/blob/master/dist/.htaccess
#
####

### Begin: Compression ###

# Compressing resource files will save bandwidth and so improve loading speed especially for users
# with slower internet connections. TYPO3 can compress the .js and .css files for you.
# *) Uncomment the following lines and
# *) Set $GLOBALS['TYPO3_CONF_VARS']['BE']['compressionLevel'] = 9 for the Backend
# *) Set $GLOBALS['TYPO3_CONF_VARS']['FE']['compressionLevel'] = 9 together with the TypoScript properties
# config.compressJs and config.compressCss for GZIP compression of Frontend JS and CSS files.

#<FilesMatch "\.js\.gzip$">
# AddType "text/javascript" .gzip
#</FilesMatch>
#<FilesMatch "\.css\.gzip$">
# AddType "text/css" .gzip
#</FilesMatch>
#AddEncoding gzip .gzip

<IfModule mod_deflate.c>
# Force compression for mangled `Accept-Encoding` request headers
<IfModule mod_setenvif.c>
<IfModule mod_headers.c>
SetEnvIfNoCase ^(Accept-EncodXng|X-cept-Encoding|X{15}|~{15}|-{15})$ ^((gzip|deflate)\s*,?\s*)+|[X~-]{4,13}$ HAVE_Accept-Encoding
RequestHeader append Accept-Encoding "gzip,deflate" env=HAVE_Accept-Encoding
</IfModule>
</IfModule>

# Compress all output labeled with one of the following media types.
#
# (!) For Apache versions below version 2.3.7 you don't need to
# enable `mod_filter` and can remove the `<IfModule mod_filter.c>`
# and `</IfModule>` lines as `AddOutputFilterByType` is still in
# the core directives.
#
# https://httpd.apache.org/docs/current/mod/mod_filter.html#addoutputfilterbytype

<IfModule mod_filter.c>
AddOutputFilterByType DEFLATE application/atom+xml \
application/javascript \
application/json \
application/ld+json \
application/manifest+json \
application/rdf+xml \
application/rss+xml \
application/schema+json \
application/vnd.geo+json \
application/vnd.ms-fontobject \
application/x-font-ttf \
application/x-javascript \
application/x-web-app-manifest+json \
application/xhtml+xml \
application/xml \
font/eot \
font/opentype \
image/bmp \
image/svg+xml \
image/vnd.microsoft.icon \
image/x-icon \
text/cache-manifest \
text/css \
text/html \
text/javascript \
text/plain \
text/vcard \
text/vnd.rim.location.xloc \
text/vtt \
text/x-component \
text/x-cross-domain-policy \
text/xml
</IfModule>

<IfModule mod_mime.c>
AddEncoding gzip svgz
</IfModule>
</IfModule>

### End: Compression ###

### Begin: Browser caching of resource files ###

# This affects Frontend and Backend and increases performance.
<IfModule mod_expires.c>

ExpiresActive on
ExpiresDefault "access plus 1 month"

ExpiresByType text/css "access plus 1 year"

ExpiresByType application/json "access plus 0 seconds"
ExpiresByType application/ld+json "access plus 0 seconds"
ExpiresByType application/schema+json "access plus 0 seconds"
ExpiresByType application/vnd.geo+json "access plus 0 seconds"
ExpiresByType application/xml "access plus 0 seconds"
ExpiresByType text/xml "access plus 0 seconds"

ExpiresByType image/vnd.microsoft.icon "access plus 1 week"
ExpiresByType image/x-icon "access plus 1 week"

ExpiresByType text/x-component "access plus 1 month"

ExpiresByType text/html "access plus 0 seconds"

ExpiresByType application/javascript "access plus 1 year"
ExpiresByType application/x-javascript "access plus 1 year"
ExpiresByType text/javascript "access plus 1 year"

ExpiresByType application/manifest+json "access plus 1 week"
ExpiresByType application/x-web-app-manifest+json "access plus 0 seconds"
ExpiresByType text/cache-manifest "access plus 0 seconds"

ExpiresByType audio/ogg "access plus 1 month"
ExpiresByType image/bmp "access plus 1 month"
ExpiresByType image/gif "access plus 1 month"
ExpiresByType image/jpeg "access plus 1 month"
ExpiresByType image/png "access plus 1 month"
ExpiresByType image/svg+xml "access plus 1 month"
ExpiresByType image/webp "access plus 1 month"
ExpiresByType video/mp4 "access plus 1 month"
ExpiresByType video/ogg "access plus 1 month"
ExpiresByType video/webm "access plus 1 month"

ExpiresByType application/atom+xml "access plus 1 hour"
ExpiresByType application/rdf+xml "access plus 1 hour"
ExpiresByType application/rss+xml "access plus 1 hour"

ExpiresByType application/vnd.ms-fontobject "access plus 1 month"
ExpiresByType font/eot "access plus 1 month"
ExpiresByType font/opentype "access plus 1 month"
ExpiresByType application/x-font-ttf "access plus 1 month"
ExpiresByType application/font-woff "access plus 1 month"
ExpiresByType application/x-font-woff "access plus 1 month"
ExpiresByType font/woff "access plus 1 month"
ExpiresByType application/font-woff2 "access plus 1 month"

ExpiresByType text/x-cross-domain-policy "access plus 1 week"

</IfModule>

### End: Browser caching of resource files ###

### Begin: MIME types ###

# Proper MIME types for all files
<IfModule mod_mime.c>

# Data interchange
AddType application/atom+xml atom
AddType application/json json map topojson
AddType application/ld+json jsonld
AddType application/rss+xml rss
AddType application/vnd.geo+json geojson
AddType application/xml rdf xml

# JavaScript
AddType application/javascript js

# Manifest files
AddType application/manifest+json webmanifest
AddType application/x-web-app-manifest+json webapp
AddType text/cache-manifest appcache

# Media files

AddType audio/mp4 f4a f4b m4a
AddType audio/ogg oga ogg opus
AddType image/bmp bmp
AddType image/svg+xml svg svgz
AddType image/webp webp
AddType video/mp4 f4v f4p m4v mp4
AddType video/ogg ogv
AddType video/webm webm
AddType video/x-flv flv
AddType image/x-icon cur ico

# Web fonts
AddType application/font-woff woff
AddType application/font-woff2 woff2
AddType application/vnd.ms-fontobject eot
AddType application/x-font-ttf ttc ttf
AddType font/opentype otf

# Other
AddType application/octet-stream safariextz
AddType application/x-bb-appworld bbaw
AddType application/x-chrome-extension crx
AddType application/x-opera-extension oex
AddType application/x-xpinstall xpi
AddType text/vcard vcard vcf
AddType text/vnd.rim.location.xloc xloc
AddType text/vtt vtt
AddType text/x-component htc

</IfModule>

# UTF-8 encoding
AddDefaultCharset utf-8
<IfModule mod_mime.c>
AddCharset utf-8 .atom .css .js .json .manifest .rdf .rss .vtt .webapp .webmanifest .xml
</IfModule>

### End: MIME types ###

### Begin: Cross Origin ###

# Send the CORS header for images when browsers request it.
<IfModule mod_setenvif.c>
<IfModule mod_headers.c>
<FilesMatch "\.(bmp|cur|gif|ico|jpe?g|png|svgz?|webp)$">
SetEnvIf Origin ":" IS_CORS
Header set Access-Control-Allow-Origin "*" env=IS_CORS
</FilesMatch>
</IfModule>
</IfModule>

# Allow cross-origin access to web fonts.
<IfModule mod_headers.c>
<FilesMatch "\.(eot|otf|tt[cf]|woff2?)$">
Header set Access-Control-Allow-Origin "*"
</FilesMatch>
</IfModule>

### End: Cross Origin ###

### Begin: Rewriting and Access ###

# You need rewriting, if you use a URL-Rewriting extension (RealURL, CoolUri).

<IfModule mod_rewrite.c>

# Enable URL rewriting
RewriteEngine On

# Store the current location in an environment variable CWD to use
# mod_rewrite in .htaccess files without knowing the RewriteBase
RewriteCond $0#%{REQUEST_URI} ([^#]*)#(.*)\1$
RewriteRule ^.*$ - [E=CWD:%2]

# Rules to set ApplicationContext based on hostname
#RewriteCond %{HTTP_HOST} ^dev\.example\.com$
#RewriteRule .? - [E=TYPO3_CONTEXT:Development]
#RewriteCond %{HTTP_HOST} ^staging\.example\.com$
#RewriteRule .? - [E=TYPO3_CONTEXT:Production/Staging]
#RewriteCond %{HTTP_HOST} ^www\.example\.com$
#RewriteRule .? - [E=TYPO3_CONTEXT:Production]

# Rule for versioned static files, configured through:
# - $GLOBALS['TYPO3_CONF_VARS']['BE']['versionNumberInFilename']
# - $GLOBALS['TYPO3_CONF_VARS']['FE']['versionNumberInFilename']
# IMPORTANT: This rule has to be the very first RewriteCond in order to work!
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^(.+)\.(\d+)\.(php|js|css|png|jpg|gif|gzip)$ %{ENV:CWD}$1.$3 [L]

# Access block for folders
RewriteRule _(?:recycler|temp)_/ - [F]
RewriteRule fileadmin/templates/.*\.(?:txt|ts)$ - [F]
RewriteRule ^(?:vendor|typo3_src|typo3temp/logs) - [F]
RewriteRule (?:typo3conf/ext|typo3/sysext|typo3/ext)/[^/]+/(?:Configuration|Resources/Private|Tests?|Documentation|docs?)/ - [F]

# Block access to all hidden files and directories with the exception of
# the visible content from within the `/.well-known/` hidden directory (RFC 5785).
RewriteCond %{REQUEST_URI} "!(^|/)\.well-known/([^./]+./?)+$" [NC]
RewriteCond %{SCRIPT_FILENAME} -d [OR]
RewriteCond %{SCRIPT_FILENAME} -f
RewriteRule (?:^|/)\. - [F]

# Stop rewrite processing, if we are in the typo3/ directory or any other known directory
# NOTE: Add your additional local storages here
RewriteRule ^(?:typo3/|fileadmin/|typo3conf/|typo3temp/|uploads/|favicon\.ico) - [L]

# If the file/symlink/directory does not exist => Redirect to index.php.
# For httpd.conf, you need to prefix each '%{REQUEST_FILENAME}' with '%{DOCUMENT_ROOT}'.
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME} !-l
RewriteRule ^.*$ %{ENV:CWD}index.php [QSA,L]

</IfModule>

# Access block for files
<FilesMatch "(?i:^\.|^#.*#|^(?:ChangeLog|ToDo|Readme|License)(?:\.md|\.txt)?|^composer\.(?:json|lock)|^ext_conf_template\.txt|^ext_typoscript_constants\.txt|^ext_typoscript_setup\.txt|flexform[^.]*\.xml|locallang[^.]*\.(?:xml|xlf)|\.(?:bak|co?nf|cfg|ya?ml|ts|dist|fla|in[ci]|log|sh|sql(?:\..*)?|sw[op]|git.*)|.*(?:~|rc))$">
# Apache < 2.3
<IfModule !mod_authz_core.c>
Order allow,deny
Deny from all
Satisfy All
</IfModule>

# Apache ≥ 2.3
<IfModule mod_authz_core.c>
Require all denied
</IfModule>
</FilesMatch>

# Block access to vcs directories
<IfModule mod_alias.c>
RedirectMatch 404 /\.(?:git|svn|hg)/
</IfModule>

### End: Rewriting and Access ###

### Begin: Miscellaneous ###

# 404 error prevention for non-existing redirected folders
Options -MultiViews

# Make sure that directory listings are disabled.
<IfModule mod_autoindex.c>
Options -Indexes
</IfModule>

<IfModule mod_headers.c>
# Force IE to render pages in the highest available mode
Header set X-UA-Compatible "IE=edge"
<FilesMatch "\.(appcache|crx|css|eot|gif|htc|ico|jpe?g|js|m4a|m4v|manifest|mp4|oex|oga|ogg|ogv|otf|pdf|png|safariextz|svgz?|ttf|vcf|webapp|webm|webp|woff2?|xml|xpi)$">
Header unset X-UA-Compatible
</FilesMatch>

# Reducing MIME type security risks
Header set X-Content-Type-Options "nosniff"
</IfModule>

# ETag removal
<IfModule mod_headers.c>
Header unset ETag
</IfModule>
FileETag None

### End: Miscellaneous ###

# Add your own rules here.

</pre>

== Update auf 6.2 ==
=== Probleme mit dem index ===
https://forge.typo3.org/issues/61154

'''Fehlermeldung''' "Migrate all file links of RTE-enabled fields to FAL" fails with "Reference index was probably out of date."

Description

Meanwhile I did upgrades from TYPO3 4.7 to 6.2 for three different instances and every time I ran into this problem.
Reason are links in content elements of hidden or (from database point of view: logical) deleted pages where the target (usually the file in fileadmin) does not exist anymore.

cli_dispatch.phpsh lowlevel_refindex -c

does not detect these broken links. So this is a deadlock during migration.

I found this workaround which requires using a SQL client for the mysql database:
1) '''check''' if the result of this query matches the list of "Reference index was probably out of date" elements

select * from sys_refindex where softref_key = 'typolink_tag' AND ref_table = '_FILE';

2) If so you can '''update''' these records:

update sys_refindex set softref_key = 'typolink' where softref_key = 'typolink_tag' AND ref_table = '_FILE';

== Update 4.5 , 4.7 ==
=== Umlautprobleme ===
evtl. auch mal bei dbinit
<pre>
SET character_set_client = utf8;
SET character_set_results = utf8;
SET character_set_connection = utf8;
</pre>

Manchmal auch bei Darstellungsproblemen oder weißer Seite

Install-Tool nach dem Parameter "
systemLocale -> de_DE.utf8
'''Bis TYPO3 4.6''': im Install-Tool den Parameter
forceCharset -> utf-8
'''Ab TYPO3 4.7''': im '''Typoscript-Setup'''
config.renderCharset = utf-8
Im '''Install-Tool''' bei "
setDBinit -> SET NAMES utf8;
eintragen (ist ab TYPO3 4.7 bereits als Standard eingetragen).

Nun den kompletten Cache leeren. Jetzt sollten die Umlaute korrekt dargestellt werden.
</pre>
Falls Sie per GIFBUILDER Text in Bilder einbauen, versuchen Sie folgendes:
<pre>
Im Install-Tool beim Parameter "t3lib_cs_convMethod" den Wert "mbstring" eintragen.
Im Install-Tool beim Parameter "t3lib_cs_utils" ebenfalls " mbstring" eintragen.
</pre>
Falls Sie Templavoila verwenden, müssen Sie darauf achten, dass Ihr HTML-Editor die Datei UTF-8-kodiert speichert. In den meisten Editoren können Sie das in den Einstellungen anpassen.

Wenn immer noch Darstellungsprobleme auftreten, kann unter Umständen eine Konvertierung der Datenbank nötig sein.

== Update Infos 4.5 ==
* Weitere Tools werden separat installiert
* utf-8 für Datenbankverbindung wird vorausgesetzt (siehe auch Typo3 auf utf-8 umstellen)
** Install-Tool $TYPO3_CONF_VARS['SYS']['setDBinit'] und $TYPO3_CONF_VARS['BE']['forceCharset'] default haben sich verändert.

* Zugriff auf veraltete php-Funktionen werden geloggt. Vorsichtig Log kann groß werden
* Extbase und Fluid

== Update Infos 4.3 ==
* simulate_static_docs muss separat installiert werden
=== Update Wizard Info ===
'''CSS Styled Content: Default targets for non-frame pages'''

The default page target is empty (so no target is generated). If you use frames, you have to set target to "page" in Constants.

'''CSS Styled Content: htmlspecialchars in menu content elements'''

Page titles will get htmlspecialchar'ed when rendered in "Sitemap/menu" content elements, to avoid generating invalid XHTML.

'''htmlArea RTE: Using CSS classes for indentation and alignment'''

* Indentation is produced by a CSS class instead of the blockquote element.
You will need to specify in Page TSConfig the class to be used for indentation using property buttons.indent.useClass (default is "indent"). You will need to define this class in your stylesheets and ensure that it is allowed by the RTE transformation (RTE.default.proc). Alternatively, you may continue using the blockquote element by setting property buttons.indent.useBlockquote. You may also want to add the new blockquote button to the RTE toolbar.

* Text alignment is produced by CSS classes instead of deprecated align attribute.
You will need to specify in Page TSConfig the class to be used for each text alignment button using property buttons.[left, center, right or justifyfull].useClass (defaults are "align-left", "align-center", "align-right", "align-justify"). You will need to define these classes in your stylesheets, and ensure that they are allowed by the RTE transformation (RTE.default.proc). Alternatively, you may continue using deprecated align attribute by setting property buttons.[left, center, right or justifyfull].useAlignAttribute.

== Update alter Typo3 Installationen (<V.3.8)==
Aus der Mailing Liste Östereich:
- der Core ist relativ easy (fast) immer zu upgraden (muesst' eigentlich von
v3.3 auch gehen ;-) )
- Achte immer auf installierte Extensions
* wenn etwas nicht geht, mal soweit wie moeglich alle Extensions wegschalten (nicht loeschen!).
* dann zuschalten; wenns dann hakt, dann sieht man gleich welche ext "boese" ist.
* dann diese ext updaten, wenns keine updates gibt, mal danach googlen.
* wenns dann net geht, debuggen..

Weitere Probleme:

Alte TS Templates arbeiten noch mit CSet und Content als default Template. Nach umstellen auf css-styled-content muß evt. einiges angepasst werden:
== Update auf 4.2 ==
<pre>
Backup erstellen (sollte selbstverständlich sein)!
Notieren welche Extensions "Global" installiert wurden, da diese später wieder erneut installiert werden müssen
Resource herunterladen:
wget kent.dl.sourceforge.net/sourceforge/typo3/typo3_src-4.2.8.tar.gz
Source-Paket entpacken:
tar -xzf typo3_src-4.2.8.tar.gz
Im Verzeichnis typo3conf müssen Sie eine Datei mit dem Namen "ENALBE_INSTALL_TOOL" erstellen bzw. uploaden (ich mache das immer mit vi ENABLE_INSTALL_TOOL )
eventuell die Rechte und die Gruppe ändern
eventuell basedir_restriction anpassen (für Plesk siehe hier)
typo3_src Symlink löschen:
rm typo3_src
neuen Symlink anlegen:
ln -s ../../typo3_src-4.2.8/ typo3_src
(den richtigen Pfad zum Source-Verzeichnis eventuell anpassen)
index.php löschen und neu erstellen:
rm index.php
ln -s typo3_src/index.php index.php
alte Verzeichnisse löschen (media, tslib)
alte Dateien löschen (showpic.php)
fehlende Verzeichnisse erstellen:
typo3conf/l10n, typo3temp/temp, typo3temp/GB, typo3temp/pics, typo3temp/llxml/, typo3temp/cs/ (sofern diese nicht schon vorhanden sind)
Installtool aufrufen und "Basic Configuration" überprüfen; hier sollte alles im grünen Bereich sein. Wenn nicht entsprechende Probleme beheben.
"Update Wizard" ausführen
Im "Database Analyser" auf "Update required tables" auf "Compare" klicken und bestätigen
Ins Backend einloggen und alle "Global" installierten Extensions nachinstallieren
Im Ext Manager unter Settings "Enable unsupported extensions" aktivieren, da zur Zeit noch nicht alle Exentensions überprüft wurden.
Im Ext Manager unter "Import extensions" auf "Retrieve/Update" klicken, um die aktuelle Liste der Extensions herunterzuladen
(Sollte es dabei zu Fehlermeldungen kommen, muss u.U. auf curl umgestellt werden) Leider ist das neue TER 2.0 extrem speicherhungrig, so dass u.U. die Speicherbeschränkung von PHP nicht ausreicht. Wenn möglich sollten Sie also zuvor den verfügbaren Speicher von PHP auf min. 45MB(!) hochsetzen. Sollten Sie dazu keine Rechte haben oder soviel Speicher nicht zur Verfügung stellen wollen, können Sie sich dadurch behelfen, dass Sie die benötigten Extensions als .t3x-Dateien herunterladen und "von Hand" installieren.
Im Ext Manager die Sprache updaten
Eventuell veraltete local-installierte Extensions erneuern (z.B. TemplaVoila, static_info_tables u.ä.)
Nicht mehr benötigte "Local"-installierte Extensions entfernen, wie z.B. csh_de, htmlarea (ist jetzt eine "System"-Extension und sollte daher local deinstalliert werden)
</pre>
== Update auf 4.1 ==
Unbedingt im Install Tool Compare ausführen und Tabellen aktualisieren. Sonst kann es Probleme mit verschiedenen Extensions geben (z.B. Login..)

== Probleme beim TYPO3 Update lösen ==
=== Weiße Seite ===
* Fehlermeldungen einschalten
=== The requested URL /typo3/alt_main.php was not found on this server.===
Symlink für index.php falsch
=== Nach dem Datenbank Compare fehlen Teile der TYPOScript Templates ===

'''Lösung'''

Von Version 4.2 auf 4.1 werden blob Felder zu Text Feldern umgewandelt. Dabei werden bei Umlauten die Inhalte abgeschnitten, wenn die Datenbank utf-8 arbeitet, TYPO3 aber die Daten in latin abgelegt hat.

Beim Compare muß man dann die blob konvertierungen weglassen (vor allem bei den Templates - in der Regel gibt es da Kommentare mit Umlauten) und leicht abgewandelt selbst durchführen:

ALTER TABLE sys_template CHANGE config config TEXT CHARACTER SET latin1;

Typo3 läßt hier die Angabe welcher Zeichensatz drin ist weg.

Die wichtigsten Statements (Stand Typo3 4.5):

<pre>
ALTER TABLE sys_template CHANGE constants constants text CHARACTER SET latin1;
ALTER TABLE sys_template CHANGE config config text CHARACTER SET latin1;
ALTER TABLE tt_content CHANGE image image text CHARACTER SET latin1;
ALTER TABLE tt_content CHANGE media media text CHARACTER SET latin1;
ALTER TABLE tt_content CHANGE pages pages tinytext CHARACTER SET latin1;
ALTER TABLE tt_content CHANGE multimedia multimedia tinytext CHARACTER SET latin1;
ALTER TABLE pages CHANGE media media text CHARACTER SET latin1;
</pre>

Link: http://dev.mysql.com/doc/refman/5.1/en/alter-table.html (Zugriff: 10/2012)

== Release Notes Version 4.1 ==
Die wichtigsten Neuerungen
* IRRE (Inline Relational Record Editing)
* AJAX Page and File Tree
* Clean-up functions (command line scripts)(Über Extension lowlevel)
* Improved Extension Manager (less memory, stored extension list)
* UTF-8 for filenames
* Backend "Who is online"
* Frontend "Stay logged in" (Konfiguration mit new login box)
* MySQL InnoDB (Wird automatisch bei Neuinstallation zur Verfügung gestellt, wenn es in mySQL aktiviert ist)
* Speed up Backend with .htaccess http://typo3.org/development/articles/release-notes-41/page/4/)

=== Manuelles ändern der Tabellen auf InnoDB ===
Hinweis persönlich rate ich von INNODB und TYPO3 ab, besser ISAM nehmen
<pre>
alter table cache_hash ENGINE = INNODB;
alter table cache_imagesizes ENGINE = INNODB;
alter table cache_md5params ENGINE = INNODB;
alter table cache_pages ENGINE = INNODB;
alter table cache_pagesection ENGINE = INNODB;
alter table cache_typo3temp_log ENGINE = INNODB;
alter table fe_sessions ENGINE = INNODB;
alter table fe_session_data ENGINE = INNODB;
alter table index_fulltext ENGINE = INNODB;
alter table index_grlist ENGINE = INNODB;
alter table index_phash ENGINE = INNODB;
alter table index_rel ENGINE = INNODB;
alter table index_section ENGINE = INNODB;
alter table index_stat_search ENGINE = INNODB;
alter table index_stat_word ENGINE = INNODB;
alter table index_words ENGINE = INNODB;
alter table sys_log ENGINE = INNODB;
</pre>

== Generelle Informationen zum Update unter Linux ==
Quelle: typo3.net Mai 2006

Typo3 ist normalerweise sehr einfach upzudaten - allerdings müssen ein paar Dinge beachtet werden, um updatefähig zu bleiben:

* Es dürfen keine Änderungen an dem Typo3-Sourcecode gemacht worden sein. Falls dieses doch gemacht wurde, müssen natürlich diese Änderungen erst in die neue Version eingearbeitet werden.
* Installierte Extensions sollten möglichst immer LOCAL installiert worden sein. So bleiben diese nach dem Tausch des Typo3-Sourcecodes unberührt und funktionieren nach dem Update (meist) wie gewohnt. Es gibt nur selten den Fall, daß eine Typo3-Version eine Funktion nicht mehr verwendet, die es in der alten Version noch gab.
* Wenn sie HTML-Templates von GLOBAL installierten Erweiterungen direkt im Extensionordner modifiziert haben sollten, müssen diese erst z.B. in den fileadmin kopiert werden. Dann können Sie den Pfad zu dieser Datei im TypoScript anpassen.

Den Pfad finden Sie überigens mithilfe des TypoScript-Object-Browsers schnell. Meist ist er an der Stelle plugin.extensionname.templateFile zu finden.

[[Bild:T3_wichtigeVerzeichnisse.gif]]

Einige der wichtigsten Verzeichnisse

'''Das Update für mittwaldmedien Kunden'''
Für unsere Kunden ist es nun besonders einfach, die vorhandene Installation auf die aktuelle Version zu bringen. Sie müssen sich nur auf der Webseite http://www.typo3server.com einloggen. Nach dem Login finden Sie ein Menü mit einem Link zu dem Typo3-Versionsmanager. Dort können Sie mit einem Klick Ihren Account auf die neue Version updaten.

'''ToDo Versionsmanager für Geo-bit'''

'''Manuelles Update'''

Für diejenigen, die dieses Update manuell machen wollen oder müssen, sind die folgenden Schrittenötig. Die Beispiele - vor allem die Pfade - müssen natürlich angepasst werden. Die Beispiele gehen davon aus, daß Sie eine Verzeichnisstruktur angelegt haben, die dem obigen Bild entspricht.

1. Machen Sie zuerst eine Datensicherung von dem Typo3-Sourcen und Ihrem html-Ordner! Die Datenbank können Sie nun über diesen Befehl sichern:

mysqldump -u benutzername -p -B --add-drop-table datenbank > typo3DBSicherung.sql

Notfalls könnte auch ein Dump mit phpMyAdmin erstellt werden.

2. Verbinden Sie sich mit Ihrem Server über SSH.

3. Wechseln Sie das Verzeichnis auf einer Ebene über dem Rootverzeichnis Ihres Webservers.
z.B.: cd /home/www/p1234/

4. Laden Sie sich die neuen Typo3-Sourcen auf ihren Linuxrechner. Die aktuellen Sourcen finden Sie unter: http://typo3.org/download/packages/.

Die benötigte Datei hat das Format typo3_src-3.x.x.tar.gz

'''Beispiel:'''

wget belnet.dl.sourceforge.net/sourceforge/typo3/typo3_src-3.7.0.tar.gz

5. Entpacken Sie die Datei mit dem Kommando:

'''Beispiel:'''

tar -xzvf typo3_src-3.x.x.tar.gz

6. Ändern Sie nun die Rechte so, wie der bisherige Typo3-Sourcecode-Ordner sie hatte.

'''Beispiel:'''

chown p1234.ftponly typo3_src-3.7.0 -R

7. Entfernen Sie den alten symbolischen Link mit:

rm typo3_src

8. Legen Sie nun einen neuen Link an mit:

ln -s typo3_src-3.x.x typo3_src

(Die Versionsnummer müssen Sie natürlich noch anpassen.)

9. Nun muss die Datenbank noch aktualisiert werden:

Gehen Sie hierzu in das Typo3-Installtool und klicken Sie auf den 2. Menüpunkt Database Analyser. Mit einem Klick auf Compare werden die zu ändernden oder zu ergänzenden Datenbankfelder angezeigt. Mit einem Klick auf "Write to database" wird die Datenbank an die neue Typo3-Version angepasst.

10. Loggen Sie sich nun als Admin im Backend an und löschen Sie alle Caches.

== Neu in Version 4 ==
* Conditions mit AND und OR (|| &&)

== Neu in 4.2 ==
Viele Usability Verbesserungen im Backend
== Update auf 4.2 ==
=== Extensions Updaten ===
* dam 1.0.11 ist nicht kompatibel Update auf min. 1.0.13
* date2cal auf >= 7.1.0
* Kickstarter 0.3.8 ist nicht kompatibel
* Developer tools gehen nicht mehr (wg. Frame oben)

=== Ablauf ===
* Backend Benutzer sperren (only Admins)
* Sicherung der Datenbank
* neue Source + Symlink
* Update Wizard
* Compare

=== Probleme ===
'''DAM Upload geht für Benutzer''' nicht mehr (Fehler Meta Daten können nicht geschrieben werden)
Beim neu indizieren geht dem dam der Media Ordner verloren. Er legt dann einen neuen an, in den er scheiben möchte. Die Benutzer sind abe noch auf den alten eingestellt. D.h. die Benutzergruppen m´üssen auf den neuen eingestellt werden.

Im Dam stehen im IE7 die Benutzerwerkzeuge nicht zur verfügung (löschen etc.) nur der Stift ist noch da.

Lösung: Das Problem ist das CSS für das Fenster. Es verdeckt die restlichen Symbole
Forum: 24.7.

Ich hatte das gleiche Problem bis vor 5 Minuten auch,
gelöst habe ich es so:
- Datei: class.tx_dam_listbase.php im Ordner DAM\lib\
Unter der Zeile 256 ('itemTD' => ' class="typo3-dblist-item"',)
ist in 3 Werten als Breite 1% angegeben. Das auskommentieren

- Datei: stylesheet.cdd in typo3_src\typo3\
table.typo3-dblist width: 98%; durch width: auto; ersetzen und in
table.typo3-dblist tr td {width: auto;} einsetzen,

damit hats bei mir im IE 7, Firefox, safari für Win und Opera alles richtig angezeigt :-)

Ich hoffe, geholrfen zu haben,
Schmoozer

Bug in Mount Points

== Datenbank über Root Shell sichern (mysql backup) ==

mysqldump -opt ...

Beispiele

Die häufigste Anwendung von mysqldump ist wahrscheinlich die '''Erstellung eines Backups einer vollständigen Datenbank''':

shell> mysqldump --opt db_name > backup-file.sql

oder mit User und Passwortangabe:
mysqldump -u meinDBUser -pGEHEIM db_name > backup.sql

--opt ist in neueren MySQL Versionen Standardmäßig an deshalb lassen wir es mal weg.

Die Speicherauszugsdatei können Sie wie folgt '''wieder einspielen'''.

shell> mysql db_name < backup-file.sql

Oder aber so:

shell> mysql -e "source /path-to-backup/backup-file.sql" db_name

mysqldump ist ferner sehr nützlich zum Ausfüllen von Datenbanken durch Kopieren von Daten von einem MySQL Server auf einen anderen:

shell> mysqldump --opt db_name | mysql --host=remote_host -C db_name

Sie können mit einem einzigen Befehl einen Speicherauszug mehrerer Datenbanken erstellen:

shell> mysqldump --databases db_name1 [db_name2 ...] > my_databases.sql

Um einen Speicherauszug aller Datenbanken zu erstellen, verwenden Sie die Option --all-databases:

shell> mysqldump --all-databases > all_databases.sql

Bei InnoDB-Tabellen bietet mysqldump die Möglichkeit, eine Online-Sicherung zu erstellen:

shell> mysqldump --all-databases --single-transaction > all_databases.sql

Diese Datensicherung muss vor Beginn des Speicherauszugsvorgangs lediglich (mit FLUSH TABLES WITH READ LOCK) eine globale Lesesperre für alle Tabellen erwirken. Sobald diese Sperre aktiv ist, werden die Koordinaten des Binärlogs ausgelesen, und die Sperre wird aufgehoben. Wenn beim Absetzen der FLUSH-Anweisung gerade eine umfangreiche Änderungsanweisung ausgeführt wird, dann – und nur dann! – kann der MySQL Server stehen bleiben, bis diese lange Anweisung ausgeführt ist; danach ist der Server sperrfrei. Wenn die vom MySQL Server empfangenen Änderungsanweisungen (in Bezug auf ihre Ausführungsdauer) kurz sind, sollte die anfängliche Sperrperiode auch bei vielen Änderungen nicht spürbar sein.

Bei der Point-in-Time-Wiederherstellung (die auch als „Roll-Forward“ bezeichnet wird, wenn Sie ein altes Backup wiederherstellen und die seitdem durchgeführten Änderungen neu aufspielen müssen) ist es häufig nützlich, das Binärlog zu rotieren (siehe Abschnitt 5.12.3, „Die binäre Update-Logdatei“) oder zumindest die Binärlogkoordinaten zu kennen, denen der Speicherauszug entspricht:

shell> mysqldump --all-databases --master-data=2 > all_databases.sql

Oder:

shell> mysqldump --all-databases --flush-logs --master-data=2
> all_databases.sql

== Mass Update Script ==

Yesterday some updates came out for TYPO3. These updates fixed certain issues and we needed to update all of our excellent shared hosting environments.

We already have a script (which is more elaborate now) that checks all our TYPO3 installations and sends the sysadmins a nice report about its findings. We use part of that report (list of paths to Document Roots) to feed the updater script.

The TYPO3 update requires you to do the followi

* update encryption key
* clear configuration cache
* clear page cache

We do not want to go into 200+ TYPO3 backends and do those tasks manually. We are lazy and we will write a script to automagically do the boring tasks for us.

This script is not perfect but it works well on Debian systems. You can modify it to fit your needs. It was just a quick hack to ease the upgrade pain. Take care to switch the symlink part for upgrade runs of different versions of TYPO3.

I am not responsible for any damage to your system that may occur to misuse of this script. Make sure you understand it before you run it. Run it with a single URI before attempting a whole ist of URI's.

Ein Massen Update Script von:

http://typofree.org/article/archive/2009/january/title/typo3-mass-upgrade-script/
Zugriff am 12.3.2009

http://typofree.org/article/archive/2009/january/title/typo3-mass-upgrade-script/

TYPO3 mass update script

1.
#!/bin/sh
2.
binDir=/usr/bin/
3.
sleep=2
4.

5.
pageCacheTables=(
6.
cache_pages
7.
cache_pagesection
8.
)
9.

10.
sites=(
11.
/var/www/sites/live/www.somedomain.tld
12.
/var/www/sites/live/www.someotherdomain.tld
13.
/var/www/sites/live/www.yetsomeotherdomain.tld
14.
)
15.

16.
len=${#sites[*]}
17.
pageCacheTablesLength=${#pageCacheTables[*]}
18.
i=0
19.
while [ $i -lt $len ]; do
20.
echo updating: ${sites[$i]}
21.
cd ${sites[$i]}
22.
rm typo3_src
23.
ln -s ../../sources/typo3_src-4.2.5 typo3_src
24.

25.
echo generating new key
26.
k=0
27.
key=''
28.
while [ $k -lt 96 ]; do
29.
key=$key$(head -100 /dev/urandom | md5sum | cut -c1)
30.
let k++
31.
done
32.
echo key: $key
33.
sed -i "s/$\$TYPO3_CONF_VARS\['SYS']\['encryptionKey'] = $.*/\1'$key';/g" typo3conf/localconf.php
34.

35.
echo removing configuration cache
36.
rm -f typo3conf/temp_CACHED*
37.

38.
echo clearing page cache
39.
# For some insane reason some values are enclosed in double qotes
40.
database=$(grep "typo_db " typo3conf/localconf.php | tail -1 | sed "s/^[^']*'$[^']*$'.*/\1/" | grep '$typo_db =')
41.
if [ -z "$database" ] ; then
42.
database=$(grep "typo_db " typo3conf/localconf.php | tail -1 | sed "s/^[^']*'$[^']*$'.*/\1/")
43.
else
44.
database=$(grep "typo_db " typo3conf/localconf.php | tail -1 | sed "s/^[^\"]*\"$[^\"]*$\".*/\1/")
45.
fi
46.
username=$(grep "typo_db_username " typo3conf/localconf.php | tail -1 | sed "s/^[^']*'$[^']*$'.*/\1/" | grep '$typo_db_username =')
47.
if [ -z "$username" ] ; then
48.
username=$(grep "typo_db_username " typo3conf/localconf.php | tail -1 | sed "s/^[^']*'$[^']*$'.*/\1/")
49.
else
50.
username=$(grep "typo_db_username " typo3conf/localconf.php | tail -1 | sed "s/^[^\"]*\"$[^\"]*$\".*/\1/")
51.
fi
52.
password=$(grep "typo_db_password " typo3conf/localconf.php | tail -1 | sed "s/^[^']*'$[^']*$'.*/\1/" | grep '$typo_db_password =')
53.
if [ -z "$password" ] ; then
54.
password=$(grep "typo_db_password " typo3conf/localconf.php | tail -1 | sed "s/^[^']*'$[^']*$'.*/\1/")
55.
else
56.
password=$(grep "typo_db_password " typo3conf/localconf.php | tail -1 | sed "s/^[^\"]*\"$[^\"]*$\".*/\1/")
57.
fi
58.
j=0
59.
while [ $j -lt $pageCacheTablesLength ];
60.
do
61.
nice -n 19 ${binDir}mysql --batch -u$username -p"$password" -D$database -e "TRUNCATE ${pageCacheTables[$j]}"
62.
nice -n 19 ${binDir}mysql --batch -u$username -p"$password" -D$database -e "ALTER TABLE ${pageCacheTables[$j]} auto_increment=1"
63.
let j++
64.
done
65.

66.
echo "done! Sleeping $sleep seconds . . ."
67.
sleep $sleep
68.

69.
echo
70.
let i++
71.
done

== Notfallhacks bei alten TYPO3 ==
=== Update auf neuere Datenbanken Fehler: character set utf8 is not used for this connection ===
'''Potentielle Probleme:'''
* TYPO3 erwartet utf8 (genauer gesagt utf8mb3)
* TYPO3 7.6 geht standardmäßig von utf8_general_ci aus. Eine neuere Datenbank verwendet aber utf8mb3_general_ci – das ist funktional fast identisch mit dem alten utf8, aber durch neuere MySQL-Versionen expliziter gemacht. Trotzdem nicht 100 % dieselbe Bezeichnung → TYPO3 könnte das als Konflikt interpretieren.
* Verbindung läuft auf utf8mb4_unicode_ci Das ist ein 4-Byte-Zeichensatz, der nicht 100% kompatibel mit utf8mb3 ist. → Bei Sortierungen oder LIKE-Abfragen könnte TYPO3 falsche Ergebnisse bekommen (z. B. bei Umlauten, Emojis, Sonderzeichen). Ist aber i.d.R. nicht die Ursache für einen Datenbankfehler.
* Server-Default ist latin1_swedish_ci Dieser Zeichensatz ist alt und wird häufig von MySQL als Fallback verwendet. Gefährlich: Wenn irgendwo keine Zeichensatzangabe erfolgt (z. B. beim Import oder bei neuen Tabellen), wird automatisch latin1 genommen – und das zerstört Umlaute.

Lösungen:
==== Tabellen prüfen ====

phpmyadmin > sql
<syntaxhighlight lang="mysql">
SHOW VARIABLES LIKE 'character_set%';
SHOW VARIABLES LIKE 'collation%';
SELECT table_name, table_collation
FROM information_schema.tables
WHERE table_schema = 'DEIN_DATENBANKNAME';
</syntaxhighlight>

Alle Tabellen sollten auf utf-8 oder utf-8 mb3 (oder mb4) stehen. Bei Bedarf umstellen:
ALTER TABLE `tabellenname` CONVERT TO CHARACTER SET utf8 COLLATE utf8_general_ci;

==== LocalConfiguration.php ====
Sicherstellen, dass utf-8 zur Übertragung verwendet wird.
<syntaxhighlight lang="php">
//...
'DB' => [
//...
'charset'=> 'utf8', // vorsichtshalber setzen
],
//...
'SYS' => [
//...
'setDBInit' => 'SET NAMES utf8', // vorsichtshalber setzen
],
</syntaxhighlight>

==== Prüfung in TYPO3 aussetzen ====
Wenn keine Möglichkeit besteht die Datenbank selbst zu beeinflussen. Kann man die problematische Prüfung in TYPO3 auskommentieren (nur als Übergang empfohlen). Unbedingt TYPO3 updaten.

/typo3_src-7.6.9/typo3/sysext/core/Classes/Database/DatabaseConnection.php

<syntaxhighlight lang="php">
/* dirty but suitable for some time
if (!$hasValidCharset) {
throw new \RuntimeException(
'It looks like the character set ' . $this->connectionCharset . ' is not used for this connection even though it is configured as connection charset. ' .
'This TYPO3 installation is using the $GLOBALS[\'TYPO3_CONF_VARS\'][\'SYS\'][\'setDBinit\'] property with the following value: "' .
$GLOBALS['TYPO3_CONF_VARS']['SYS']['setDBinit'] . '". Please make sure that this command does not overwrite the configured charset. ' .
'Please note that for the TYPO3 database everything other than utf8 is unsupported since version 4.7.',
1389697515
);
} */
</syntaxhighlight>

TYPO3-Cache leeren (Install Tool oder /typo3temp/Cache/*)

Typo3 - Update

2025-08-07T10:49:35Z

109.193.152.88:

== Links ==
http://wiki.typo3.org/Upgrade

[[TYPO3 - Troubleshooting Version 8]]
[[TYPO3 - Änderungen Version 9]]
== Aufräumen vor dem Update ==
http://typo3blogger.de/turchen-2-tutorial-typo3-entrumpeln/

=== Files ===
* kb_cleanfiles.
* Modul unter „DB-Überprüfung“ -> „Database Relations“. Neben dem Listing „Dateien, die in keinem Eintrag verwendet werden (bitte löschen!):“, welches der inhaltlichen Ausgabe der Extension sehr ähnelt, wird hier auch angezeigt ob Dateien doppelt referenziert werden
* typo3temp über install tool
=== Datenbank ===
* kj_recycler für papierkorb Daten danach refefence Index updaten
* cache_ Tabellen leeren
* sys_histroy leeren

Zur Not alles löschbar...

<pre>
[PHP]TRUNCATE TABLE sys_log //e.g. alle älter als 14 Tage
TRUNCATE TABLE sys_history //e.g. alle änderungen älter als 30 Tage

TRUNCATE TABLE index_fulltext
TRUNCATE TABLE index_grlist
TRUNCATE TABLE index_phash
TRUNCATE TABLE index_rel
TRUNCATE TABLE index_section
TRUNCATE TABLE index_stat_search
TRUNCATE TABLE index_stat_word
TRUNCATE TABLE index_words

TRUNCATE TABLE cache_pages
TRUNCATE TABLE cache_hash
TRUNCATE TABLE cache_imagesizes
TRUNCATE TABLE cache_pagesection
TRUNCATE TABLE cache_treelist
TRUNCATE TABLE cache_typo3temp_log
TRUNCATE TABLE cache_extensions

TRUNCATE TABLE tx_realurl_errorlog

TRUNCATE TABLE be_sessions
TRUNCATE TABLE fe_sessions
TRUNCATE TABLE fe_session_data[/PHP]

</pre>

== PHP Updates ==
=== PHP 5.5 2017 - Kurzanleitung ===
Kurzanleitung Update auf PHP 5.5 für TYPO3 4.5.x
<pre>
Wichtig
htaccess aktualisieren
Source aktualisieren
Umstellung utf8
- DB Export
- Textmate in utf-8 speichern
- Ersetzen von CHARSET=latin1 durch CHARSET=utf8
- Ersetzen der COLLATE
</pre>

localconf.php
=== PHP 5.6 2018 für TYPO 3 4.5 / 6.0===
Hinweis: 6.2 sollte laufen. Ältere Versionen sind ohnehin nicht mehr sicher.

Quelle:
http://www.typo3forum.net/discussion/79348/geloest-toolbaritem-shortcuts-must-implement-interface-backend-toolbaritem
https://www.typo3.net/forum/thematik/zeige/thema/123471/
Eine Suche im Netz ergab, dass T3 in der von mir verwendeten Version nicht mit PHP 5.6 kompatibel ist.

Unter diesem Link habe ich aber gefunden, wie man - bis zu einem Upgrade auf wenigstens 6.2 - das Backend wieder zum Laufen bekommt. Dazu müsste in folgenden Dateien über die Shell der Aufruf "&$backendReference" durch "$backendReference" ersetzt werden:

www/cms/typo3/classes/class.clearcachemenu.php:55:
www/cms/typo3/classes/class.livesearch.php:51:
www/cms/typo3/classes/class.shortcutmenu.php:79:
www/cms/typo3/interfaces/interface.backend_toolbaritem.php:43:
www/cms/typo3/sysext/opendocs/class.tx_opendocs.php:61:
www/cms/typo3/sysext/sys_action/toolbarmenu/class.tx_sysaction_toolbarmenu.php:53:
www/cms/typo3/sysext/sys_action/toolbarmenu/class.tx_sysaction_toolbarmenu.php:63:
www/cms/typo3/sysext/workspaces/Classes/BackendUserInterface/WorkspaceSelectorToolbarItem.php:59:

und zusätzlich noch

www/cms/typo3/classes/class.backendsearchmenu.php:52:
www/cms/typo3/classes/class.workspaceselector.php:57:
www/cms/typo3/sysext/workspaces/Classes/ExtDirect/WorkspaceSelectorToolbarItem.php:59

== Probleme lösen Version 7 ==
=== Update auf neuere Datenbanken Fehler: character set utf8 is not used for this connection ===
'''Potentielle Probleme:'''
* TYPO3 erwartet utf8 (genauer gesagt utf8mb3)
* TYPO3 7.6 geht standardmäßig von utf8_general_ci aus. Eine neuere Datenbank verwendet aber utf8mb3_general_ci – das ist funktional fast identisch mit dem alten utf8, aber durch neuere MySQL-Versionen expliziter gemacht. Trotzdem nicht 100 % dieselbe Bezeichnung → TYPO3 könnte das als Konflikt interpretieren.
* Verbindung läuft auf utf8mb4_unicode_ci Das ist ein 4-Byte-Zeichensatz, der nicht 100% kompatibel mit utf8mb3 ist. → Bei Sortierungen oder LIKE-Abfragen könnte TYPO3 falsche Ergebnisse bekommen (z. B. bei Umlauten, Emojis, Sonderzeichen). Ist aber i.d.R. nicht die Ursache für einen Datenbankfehler.
* Server-Default ist latin1_swedish_ci Dieser Zeichensatz ist alt und wird häufig von MySQL als Fallback verwendet. Gefährlich: Wenn irgendwo keine Zeichensatzangabe erfolgt (z. B. beim Import oder bei neuen Tabellen), wird automatisch latin1 genommen – und das zerstört Umlaute.

Lösungen:
==== Tabellen prüfen ====

== Update auf 7 ==
https://jweiland.net/video-anleitungen/typo3/typo3-projekte-verwalten/upgrade-typo3-62-auf-7.html
[[TYPO3 Update - 6 auf 7]]
https://jweiland.net/video-anleitungen/typo3/typo3-projekte-verwalten/typo3-7-lts-migration-von-css-styled-content-nach-fluid-styled-content.html
* css_styled_content wird durch fluid_styled_content ersetzt
* FSC bringt eigene CSS-Klassen für das Frontend mit. Anpassungen im CSS einer Website sind notwendig.
* Die Funktion "Rahmen und Einrückungen (section_frames)" gibt es nicht mehr. Hier muss bei Bedarf auf das "Layout"-Feld ausgewichen werden.
* Überschriften lassen sich nicht mehr direkt zentrieren oder rechts ausrichten.
* Die Bildeffekte (Drehung, Graustufen etc.) gibt es auch nicht mehr.

=== Fluid Styled Content ersetzt CSS Styled Content ===
[[TYPO3 - fluid_styled_content]]

=== htaccess für all-inkl TYPO3 v7===
So machts der Auto Installer:
<pre>
php_value always_populate_raw_post_data -1
php_value memory_limit 256M
php_value max_execution_time 240
<FilesMatch "\.(php.*|phtml)\.">
RewriteEngine on
RewriteRule .* - [R=403,L]
</FilesMatch>
#####
#
# Example .htaccess file for TYPO3 CMS - for use with Apache Webserver
#
# This file includes settings for the following configuration options:
#
# - Compression
# - Caching
# - MIME types
# - Cross Origin requests
# - Rewriting and Access
# - Miscellaneous
# - PHP optimisation
#
# If you want to use it, you have to copy it to the root folder of your TYPO3 installation (if its
# not there already) and rename it to '.htaccess'. To make .htaccess files work, you might need to
# adjust the 'AllowOverride' directive in your Apache configuration file.
#
# IMPORTANT: You may need to change this file depending on your TYPO3 installation!
# Consider adding this file's content to your webserver's configuration directly for speed improvement
#
# Lots of the options are taken from https://github.com/h5bp/html5-boilerplate/blob/master/dist/.htaccess
#
####

### Begin: Compression ###

# Compressing resource files will save bandwidth and so improve loading speed especially for users
# with slower internet connections. TYPO3 can compress the .js and .css files for you.
# *) Uncomment the following lines and
# *) Set $GLOBALS['TYPO3_CONF_VARS']['BE']['compressionLevel'] = 9 for the Backend
# *) Set $GLOBALS['TYPO3_CONF_VARS']['FE']['compressionLevel'] = 9 together with the TypoScript properties
# config.compressJs and config.compressCss for GZIP compression of Frontend JS and CSS files.

#<FilesMatch "\.js\.gzip$">
# AddType "text/javascript" .gzip
#</FilesMatch>
#<FilesMatch "\.css\.gzip$">
# AddType "text/css" .gzip
#</FilesMatch>
#AddEncoding gzip .gzip

<IfModule mod_deflate.c>
# Force compression for mangled `Accept-Encoding` request headers
<IfModule mod_setenvif.c>
<IfModule mod_headers.c>
SetEnvIfNoCase ^(Accept-EncodXng|X-cept-Encoding|X{15}|~{15}|-{15})$ ^((gzip|deflate)\s*,?\s*)+|[X~-]{4,13}$ HAVE_Accept-Encoding
RequestHeader append Accept-Encoding "gzip,deflate" env=HAVE_Accept-Encoding
</IfModule>
</IfModule>

# Compress all output labeled with one of the following media types.
#
# (!) For Apache versions below version 2.3.7 you don't need to
# enable `mod_filter` and can remove the `<IfModule mod_filter.c>`
# and `</IfModule>` lines as `AddOutputFilterByType` is still in
# the core directives.
#
# https://httpd.apache.org/docs/current/mod/mod_filter.html#addoutputfilterbytype

<IfModule mod_filter.c>
AddOutputFilterByType DEFLATE application/atom+xml \
application/javascript \
application/json \
application/ld+json \
application/manifest+json \
application/rdf+xml \
application/rss+xml \
application/schema+json \
application/vnd.geo+json \
application/vnd.ms-fontobject \
application/x-font-ttf \
application/x-javascript \
application/x-web-app-manifest+json \
application/xhtml+xml \
application/xml \
font/eot \
font/opentype \
image/bmp \
image/svg+xml \
image/vnd.microsoft.icon \
image/x-icon \
text/cache-manifest \
text/css \
text/html \
text/javascript \
text/plain \
text/vcard \
text/vnd.rim.location.xloc \
text/vtt \
text/x-component \
text/x-cross-domain-policy \
text/xml
</IfModule>

<IfModule mod_mime.c>
AddEncoding gzip svgz
</IfModule>
</IfModule>

### End: Compression ###

### Begin: Browser caching of resource files ###

# This affects Frontend and Backend and increases performance.
<IfModule mod_expires.c>

ExpiresActive on
ExpiresDefault "access plus 1 month"

ExpiresByType text/css "access plus 1 year"

ExpiresByType application/json "access plus 0 seconds"
ExpiresByType application/ld+json "access plus 0 seconds"
ExpiresByType application/schema+json "access plus 0 seconds"
ExpiresByType application/vnd.geo+json "access plus 0 seconds"
ExpiresByType application/xml "access plus 0 seconds"
ExpiresByType text/xml "access plus 0 seconds"

ExpiresByType image/vnd.microsoft.icon "access plus 1 week"
ExpiresByType image/x-icon "access plus 1 week"

ExpiresByType text/x-component "access plus 1 month"

ExpiresByType text/html "access plus 0 seconds"

ExpiresByType application/javascript "access plus 1 year"
ExpiresByType application/x-javascript "access plus 1 year"
ExpiresByType text/javascript "access plus 1 year"

ExpiresByType application/manifest+json "access plus 1 week"
ExpiresByType application/x-web-app-manifest+json "access plus 0 seconds"
ExpiresByType text/cache-manifest "access plus 0 seconds"

ExpiresByType audio/ogg "access plus 1 month"
ExpiresByType image/bmp "access plus 1 month"
ExpiresByType image/gif "access plus 1 month"
ExpiresByType image/jpeg "access plus 1 month"
ExpiresByType image/png "access plus 1 month"
ExpiresByType image/svg+xml "access plus 1 month"
ExpiresByType image/webp "access plus 1 month"
ExpiresByType video/mp4 "access plus 1 month"
ExpiresByType video/ogg "access plus 1 month"
ExpiresByType video/webm "access plus 1 month"

ExpiresByType application/atom+xml "access plus 1 hour"
ExpiresByType application/rdf+xml "access plus 1 hour"
ExpiresByType application/rss+xml "access plus 1 hour"

ExpiresByType application/vnd.ms-fontobject "access plus 1 month"
ExpiresByType font/eot "access plus 1 month"
ExpiresByType font/opentype "access plus 1 month"
ExpiresByType application/x-font-ttf "access plus 1 month"
ExpiresByType application/font-woff "access plus 1 month"
ExpiresByType application/x-font-woff "access plus 1 month"
ExpiresByType font/woff "access plus 1 month"
ExpiresByType application/font-woff2 "access plus 1 month"

ExpiresByType text/x-cross-domain-policy "access plus 1 week"

</IfModule>

### End: Browser caching of resource files ###

### Begin: MIME types ###

# Proper MIME types for all files
<IfModule mod_mime.c>

# Data interchange
AddType application/atom+xml atom
AddType application/json json map topojson
AddType application/ld+json jsonld
AddType application/rss+xml rss
AddType application/vnd.geo+json geojson
AddType application/xml rdf xml

# JavaScript
AddType application/javascript js

# Manifest files
AddType application/manifest+json webmanifest
AddType application/x-web-app-manifest+json webapp
AddType text/cache-manifest appcache

# Media files

AddType audio/mp4 f4a f4b m4a
AddType audio/ogg oga ogg opus
AddType image/bmp bmp
AddType image/svg+xml svg svgz
AddType image/webp webp
AddType video/mp4 f4v f4p m4v mp4
AddType video/ogg ogv
AddType video/webm webm
AddType video/x-flv flv
AddType image/x-icon cur ico

# Web fonts
AddType application/font-woff woff
AddType application/font-woff2 woff2
AddType application/vnd.ms-fontobject eot
AddType application/x-font-ttf ttc ttf
AddType font/opentype otf

# Other
AddType application/octet-stream safariextz
AddType application/x-bb-appworld bbaw
AddType application/x-chrome-extension crx
AddType application/x-opera-extension oex
AddType application/x-xpinstall xpi
AddType text/vcard vcard vcf
AddType text/vnd.rim.location.xloc xloc
AddType text/vtt vtt
AddType text/x-component htc

</IfModule>

# UTF-8 encoding
AddDefaultCharset utf-8
<IfModule mod_mime.c>
AddCharset utf-8 .atom .css .js .json .manifest .rdf .rss .vtt .webapp .webmanifest .xml
</IfModule>

### End: MIME types ###

### Begin: Cross Origin ###

# Send the CORS header for images when browsers request it.
<IfModule mod_setenvif.c>
<IfModule mod_headers.c>
<FilesMatch "\.(bmp|cur|gif|ico|jpe?g|png|svgz?|webp)$">
SetEnvIf Origin ":" IS_CORS
Header set Access-Control-Allow-Origin "*" env=IS_CORS
</FilesMatch>
</IfModule>
</IfModule>

# Allow cross-origin access to web fonts.
<IfModule mod_headers.c>
<FilesMatch "\.(eot|otf|tt[cf]|woff2?)$">
Header set Access-Control-Allow-Origin "*"
</FilesMatch>
</IfModule>

### End: Cross Origin ###

### Begin: Rewriting and Access ###

# You need rewriting, if you use a URL-Rewriting extension (RealURL, CoolUri).

<IfModule mod_rewrite.c>

# Enable URL rewriting
RewriteEngine On

# Store the current location in an environment variable CWD to use
# mod_rewrite in .htaccess files without knowing the RewriteBase
RewriteCond $0#%{REQUEST_URI} ([^#]*)#(.*)\1$
RewriteRule ^.*$ - [E=CWD:%2]

# Rules to set ApplicationContext based on hostname
#RewriteCond %{HTTP_HOST} ^dev\.example\.com$
#RewriteRule .? - [E=TYPO3_CONTEXT:Development]
#RewriteCond %{HTTP_HOST} ^staging\.example\.com$
#RewriteRule .? - [E=TYPO3_CONTEXT:Production/Staging]
#RewriteCond %{HTTP_HOST} ^www\.example\.com$
#RewriteRule .? - [E=TYPO3_CONTEXT:Production]

# Rule for versioned static files, configured through:
# - $GLOBALS['TYPO3_CONF_VARS']['BE']['versionNumberInFilename']
# - $GLOBALS['TYPO3_CONF_VARS']['FE']['versionNumberInFilename']
# IMPORTANT: This rule has to be the very first RewriteCond in order to work!
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^(.+)\.(\d+)\.(php|js|css|png|jpg|gif|gzip)$ %{ENV:CWD}$1.$3 [L]

# Access block for folders
RewriteRule _(?:recycler|temp)_/ - [F]
RewriteRule fileadmin/templates/.*\.(?:txt|ts)$ - [F]
RewriteRule ^(?:vendor|typo3_src|typo3temp/logs) - [F]
RewriteRule (?:typo3conf/ext|typo3/sysext|typo3/ext)/[^/]+/(?:Configuration|Resources/Private|Tests?|Documentation|docs?)/ - [F]

# Block access to all hidden files and directories with the exception of
# the visible content from within the `/.well-known/` hidden directory (RFC 5785).
RewriteCond %{REQUEST_URI} "!(^|/)\.well-known/([^./]+./?)+$" [NC]
RewriteCond %{SCRIPT_FILENAME} -d [OR]
RewriteCond %{SCRIPT_FILENAME} -f
RewriteRule (?:^|/)\. - [F]

# Stop rewrite processing, if we are in the typo3/ directory or any other known directory
# NOTE: Add your additional local storages here
RewriteRule ^(?:typo3/|fileadmin/|typo3conf/|typo3temp/|uploads/|favicon\.ico) - [L]

# If the file/symlink/directory does not exist => Redirect to index.php.
# For httpd.conf, you need to prefix each '%{REQUEST_FILENAME}' with '%{DOCUMENT_ROOT}'.
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME} !-l
RewriteRule ^.*$ %{ENV:CWD}index.php [QSA,L]

</IfModule>

# Access block for files
<FilesMatch "(?i:^\.|^#.*#|^(?:ChangeLog|ToDo|Readme|License)(?:\.md|\.txt)?|^composer\.(?:json|lock)|^ext_conf_template\.txt|^ext_typoscript_constants\.txt|^ext_typoscript_setup\.txt|flexform[^.]*\.xml|locallang[^.]*\.(?:xml|xlf)|\.(?:bak|co?nf|cfg|ya?ml|ts|dist|fla|in[ci]|log|sh|sql(?:\..*)?|sw[op]|git.*)|.*(?:~|rc))$">
# Apache < 2.3
<IfModule !mod_authz_core.c>
Order allow,deny
Deny from all
Satisfy All
</IfModule>

# Apache ≥ 2.3
<IfModule mod_authz_core.c>
Require all denied
</IfModule>
</FilesMatch>

# Block access to vcs directories
<IfModule mod_alias.c>
RedirectMatch 404 /\.(?:git|svn|hg)/
</IfModule>

### End: Rewriting and Access ###

### Begin: Miscellaneous ###

# 404 error prevention for non-existing redirected folders
Options -MultiViews

# Make sure that directory listings are disabled.
<IfModule mod_autoindex.c>
Options -Indexes
</IfModule>

<IfModule mod_headers.c>
# Force IE to render pages in the highest available mode
Header set X-UA-Compatible "IE=edge"
<FilesMatch "\.(appcache|crx|css|eot|gif|htc|ico|jpe?g|js|m4a|m4v|manifest|mp4|oex|oga|ogg|ogv|otf|pdf|png|safariextz|svgz?|ttf|vcf|webapp|webm|webp|woff2?|xml|xpi)$">
Header unset X-UA-Compatible
</FilesMatch>

# Reducing MIME type security risks
Header set X-Content-Type-Options "nosniff"
</IfModule>

# ETag removal
<IfModule mod_headers.c>
Header unset ETag
</IfModule>
FileETag None

### End: Miscellaneous ###

# Add your own rules here.

</pre>

== Update auf 6.2 ==
=== Probleme mit dem index ===
https://forge.typo3.org/issues/61154

'''Fehlermeldung''' "Migrate all file links of RTE-enabled fields to FAL" fails with "Reference index was probably out of date."

Description

Meanwhile I did upgrades from TYPO3 4.7 to 6.2 for three different instances and every time I ran into this problem.
Reason are links in content elements of hidden or (from database point of view: logical) deleted pages where the target (usually the file in fileadmin) does not exist anymore.

cli_dispatch.phpsh lowlevel_refindex -c

does not detect these broken links. So this is a deadlock during migration.

I found this workaround which requires using a SQL client for the mysql database:
1) '''check''' if the result of this query matches the list of "Reference index was probably out of date" elements

select * from sys_refindex where softref_key = 'typolink_tag' AND ref_table = '_FILE';

2) If so you can '''update''' these records:

update sys_refindex set softref_key = 'typolink' where softref_key = 'typolink_tag' AND ref_table = '_FILE';

== Update 4.5 , 4.7 ==
=== Umlautprobleme ===
evtl. auch mal bei dbinit
<pre>
SET character_set_client = utf8;
SET character_set_results = utf8;
SET character_set_connection = utf8;
</pre>

Manchmal auch bei Darstellungsproblemen oder weißer Seite

Install-Tool nach dem Parameter "
systemLocale -> de_DE.utf8
'''Bis TYPO3 4.6''': im Install-Tool den Parameter
forceCharset -> utf-8
'''Ab TYPO3 4.7''': im '''Typoscript-Setup'''
config.renderCharset = utf-8
Im '''Install-Tool''' bei "
setDBinit -> SET NAMES utf8;
eintragen (ist ab TYPO3 4.7 bereits als Standard eingetragen).

Nun den kompletten Cache leeren. Jetzt sollten die Umlaute korrekt dargestellt werden.
</pre>
Falls Sie per GIFBUILDER Text in Bilder einbauen, versuchen Sie folgendes:
<pre>
Im Install-Tool beim Parameter "t3lib_cs_convMethod" den Wert "mbstring" eintragen.
Im Install-Tool beim Parameter "t3lib_cs_utils" ebenfalls " mbstring" eintragen.
</pre>
Falls Sie Templavoila verwenden, müssen Sie darauf achten, dass Ihr HTML-Editor die Datei UTF-8-kodiert speichert. In den meisten Editoren können Sie das in den Einstellungen anpassen.

Wenn immer noch Darstellungsprobleme auftreten, kann unter Umständen eine Konvertierung der Datenbank nötig sein.

== Update Infos 4.5 ==
* Weitere Tools werden separat installiert
* utf-8 für Datenbankverbindung wird vorausgesetzt (siehe auch Typo3 auf utf-8 umstellen)
** Install-Tool $TYPO3_CONF_VARS['SYS']['setDBinit'] und $TYPO3_CONF_VARS['BE']['forceCharset'] default haben sich verändert.

* Zugriff auf veraltete php-Funktionen werden geloggt. Vorsichtig Log kann groß werden
* Extbase und Fluid

== Update Infos 4.3 ==
* simulate_static_docs muss separat installiert werden
=== Update Wizard Info ===
'''CSS Styled Content: Default targets for non-frame pages'''

The default page target is empty (so no target is generated). If you use frames, you have to set target to "page" in Constants.

'''CSS Styled Content: htmlspecialchars in menu content elements'''

Page titles will get htmlspecialchar'ed when rendered in "Sitemap/menu" content elements, to avoid generating invalid XHTML.

'''htmlArea RTE: Using CSS classes for indentation and alignment'''

* Indentation is produced by a CSS class instead of the blockquote element.
You will need to specify in Page TSConfig the class to be used for indentation using property buttons.indent.useClass (default is "indent"). You will need to define this class in your stylesheets and ensure that it is allowed by the RTE transformation (RTE.default.proc). Alternatively, you may continue using the blockquote element by setting property buttons.indent.useBlockquote. You may also want to add the new blockquote button to the RTE toolbar.

* Text alignment is produced by CSS classes instead of deprecated align attribute.
You will need to specify in Page TSConfig the class to be used for each text alignment button using property buttons.[left, center, right or justifyfull].useClass (defaults are "align-left", "align-center", "align-right", "align-justify"). You will need to define these classes in your stylesheets, and ensure that they are allowed by the RTE transformation (RTE.default.proc). Alternatively, you may continue using deprecated align attribute by setting property buttons.[left, center, right or justifyfull].useAlignAttribute.

== Update alter Typo3 Installationen (<V.3.8)==
Aus der Mailing Liste Östereich:
- der Core ist relativ easy (fast) immer zu upgraden (muesst' eigentlich von
v3.3 auch gehen ;-) )
- Achte immer auf installierte Extensions
* wenn etwas nicht geht, mal soweit wie moeglich alle Extensions wegschalten (nicht loeschen!).
* dann zuschalten; wenns dann hakt, dann sieht man gleich welche ext "boese" ist.
* dann diese ext updaten, wenns keine updates gibt, mal danach googlen.
* wenns dann net geht, debuggen..

Weitere Probleme:

Alte TS Templates arbeiten noch mit CSet und Content als default Template. Nach umstellen auf css-styled-content muß evt. einiges angepasst werden:
== Update auf 4.2 ==
<pre>
Backup erstellen (sollte selbstverständlich sein)!
Notieren welche Extensions "Global" installiert wurden, da diese später wieder erneut installiert werden müssen
Resource herunterladen:
wget kent.dl.sourceforge.net/sourceforge/typo3/typo3_src-4.2.8.tar.gz
Source-Paket entpacken:
tar -xzf typo3_src-4.2.8.tar.gz
Im Verzeichnis typo3conf müssen Sie eine Datei mit dem Namen "ENALBE_INSTALL_TOOL" erstellen bzw. uploaden (ich mache das immer mit vi ENABLE_INSTALL_TOOL )
eventuell die Rechte und die Gruppe ändern
eventuell basedir_restriction anpassen (für Plesk siehe hier)
typo3_src Symlink löschen:
rm typo3_src
neuen Symlink anlegen:
ln -s ../../typo3_src-4.2.8/ typo3_src
(den richtigen Pfad zum Source-Verzeichnis eventuell anpassen)
index.php löschen und neu erstellen:
rm index.php
ln -s typo3_src/index.php index.php
alte Verzeichnisse löschen (media, tslib)
alte Dateien löschen (showpic.php)
fehlende Verzeichnisse erstellen:
typo3conf/l10n, typo3temp/temp, typo3temp/GB, typo3temp/pics, typo3temp/llxml/, typo3temp/cs/ (sofern diese nicht schon vorhanden sind)
Installtool aufrufen und "Basic Configuration" überprüfen; hier sollte alles im grünen Bereich sein. Wenn nicht entsprechende Probleme beheben.
"Update Wizard" ausführen
Im "Database Analyser" auf "Update required tables" auf "Compare" klicken und bestätigen
Ins Backend einloggen und alle "Global" installierten Extensions nachinstallieren
Im Ext Manager unter Settings "Enable unsupported extensions" aktivieren, da zur Zeit noch nicht alle Exentensions überprüft wurden.
Im Ext Manager unter "Import extensions" auf "Retrieve/Update" klicken, um die aktuelle Liste der Extensions herunterzuladen
(Sollte es dabei zu Fehlermeldungen kommen, muss u.U. auf curl umgestellt werden) Leider ist das neue TER 2.0 extrem speicherhungrig, so dass u.U. die Speicherbeschränkung von PHP nicht ausreicht. Wenn möglich sollten Sie also zuvor den verfügbaren Speicher von PHP auf min. 45MB(!) hochsetzen. Sollten Sie dazu keine Rechte haben oder soviel Speicher nicht zur Verfügung stellen wollen, können Sie sich dadurch behelfen, dass Sie die benötigten Extensions als .t3x-Dateien herunterladen und "von Hand" installieren.
Im Ext Manager die Sprache updaten
Eventuell veraltete local-installierte Extensions erneuern (z.B. TemplaVoila, static_info_tables u.ä.)
Nicht mehr benötigte "Local"-installierte Extensions entfernen, wie z.B. csh_de, htmlarea (ist jetzt eine "System"-Extension und sollte daher local deinstalliert werden)
</pre>
== Update auf 4.1 ==
Unbedingt im Install Tool Compare ausführen und Tabellen aktualisieren. Sonst kann es Probleme mit verschiedenen Extensions geben (z.B. Login..)

== Probleme beim TYPO3 Update lösen ==
=== Weiße Seite ===
* Fehlermeldungen einschalten
=== The requested URL /typo3/alt_main.php was not found on this server.===
Symlink für index.php falsch
=== Nach dem Datenbank Compare fehlen Teile der TYPOScript Templates ===

'''Lösung'''

Von Version 4.2 auf 4.1 werden blob Felder zu Text Feldern umgewandelt. Dabei werden bei Umlauten die Inhalte abgeschnitten, wenn die Datenbank utf-8 arbeitet, TYPO3 aber die Daten in latin abgelegt hat.

Beim Compare muß man dann die blob konvertierungen weglassen (vor allem bei den Templates - in der Regel gibt es da Kommentare mit Umlauten) und leicht abgewandelt selbst durchführen:

ALTER TABLE sys_template CHANGE config config TEXT CHARACTER SET latin1;

Typo3 läßt hier die Angabe welcher Zeichensatz drin ist weg.

Die wichtigsten Statements (Stand Typo3 4.5):

<pre>
ALTER TABLE sys_template CHANGE constants constants text CHARACTER SET latin1;
ALTER TABLE sys_template CHANGE config config text CHARACTER SET latin1;
ALTER TABLE tt_content CHANGE image image text CHARACTER SET latin1;
ALTER TABLE tt_content CHANGE media media text CHARACTER SET latin1;
ALTER TABLE tt_content CHANGE pages pages tinytext CHARACTER SET latin1;
ALTER TABLE tt_content CHANGE multimedia multimedia tinytext CHARACTER SET latin1;
ALTER TABLE pages CHANGE media media text CHARACTER SET latin1;
</pre>

Link: http://dev.mysql.com/doc/refman/5.1/en/alter-table.html (Zugriff: 10/2012)

== Release Notes Version 4.1 ==
Die wichtigsten Neuerungen
* IRRE (Inline Relational Record Editing)
* AJAX Page and File Tree
* Clean-up functions (command line scripts)(Über Extension lowlevel)
* Improved Extension Manager (less memory, stored extension list)
* UTF-8 for filenames
* Backend "Who is online"
* Frontend "Stay logged in" (Konfiguration mit new login box)
* MySQL InnoDB (Wird automatisch bei Neuinstallation zur Verfügung gestellt, wenn es in mySQL aktiviert ist)
* Speed up Backend with .htaccess http://typo3.org/development/articles/release-notes-41/page/4/)

=== Manuelles ändern der Tabellen auf InnoDB ===
Hinweis persönlich rate ich von INNODB und TYPO3 ab, besser ISAM nehmen
<pre>
alter table cache_hash ENGINE = INNODB;
alter table cache_imagesizes ENGINE = INNODB;
alter table cache_md5params ENGINE = INNODB;
alter table cache_pages ENGINE = INNODB;
alter table cache_pagesection ENGINE = INNODB;
alter table cache_typo3temp_log ENGINE = INNODB;
alter table fe_sessions ENGINE = INNODB;
alter table fe_session_data ENGINE = INNODB;
alter table index_fulltext ENGINE = INNODB;
alter table index_grlist ENGINE = INNODB;
alter table index_phash ENGINE = INNODB;
alter table index_rel ENGINE = INNODB;
alter table index_section ENGINE = INNODB;
alter table index_stat_search ENGINE = INNODB;
alter table index_stat_word ENGINE = INNODB;
alter table index_words ENGINE = INNODB;
alter table sys_log ENGINE = INNODB;
</pre>

== Generelle Informationen zum Update unter Linux ==
Quelle: typo3.net Mai 2006

Typo3 ist normalerweise sehr einfach upzudaten - allerdings müssen ein paar Dinge beachtet werden, um updatefähig zu bleiben:

* Es dürfen keine Änderungen an dem Typo3-Sourcecode gemacht worden sein. Falls dieses doch gemacht wurde, müssen natürlich diese Änderungen erst in die neue Version eingearbeitet werden.
* Installierte Extensions sollten möglichst immer LOCAL installiert worden sein. So bleiben diese nach dem Tausch des Typo3-Sourcecodes unberührt und funktionieren nach dem Update (meist) wie gewohnt. Es gibt nur selten den Fall, daß eine Typo3-Version eine Funktion nicht mehr verwendet, die es in der alten Version noch gab.
* Wenn sie HTML-Templates von GLOBAL installierten Erweiterungen direkt im Extensionordner modifiziert haben sollten, müssen diese erst z.B. in den fileadmin kopiert werden. Dann können Sie den Pfad zu dieser Datei im TypoScript anpassen.

Den Pfad finden Sie überigens mithilfe des TypoScript-Object-Browsers schnell. Meist ist er an der Stelle plugin.extensionname.templateFile zu finden.

[[Bild:T3_wichtigeVerzeichnisse.gif]]

Einige der wichtigsten Verzeichnisse

'''Das Update für mittwaldmedien Kunden'''
Für unsere Kunden ist es nun besonders einfach, die vorhandene Installation auf die aktuelle Version zu bringen. Sie müssen sich nur auf der Webseite http://www.typo3server.com einloggen. Nach dem Login finden Sie ein Menü mit einem Link zu dem Typo3-Versionsmanager. Dort können Sie mit einem Klick Ihren Account auf die neue Version updaten.

'''ToDo Versionsmanager für Geo-bit'''

'''Manuelles Update'''

Für diejenigen, die dieses Update manuell machen wollen oder müssen, sind die folgenden Schrittenötig. Die Beispiele - vor allem die Pfade - müssen natürlich angepasst werden. Die Beispiele gehen davon aus, daß Sie eine Verzeichnisstruktur angelegt haben, die dem obigen Bild entspricht.

1. Machen Sie zuerst eine Datensicherung von dem Typo3-Sourcen und Ihrem html-Ordner! Die Datenbank können Sie nun über diesen Befehl sichern:

mysqldump -u benutzername -p -B --add-drop-table datenbank > typo3DBSicherung.sql

Notfalls könnte auch ein Dump mit phpMyAdmin erstellt werden.

2. Verbinden Sie sich mit Ihrem Server über SSH.

3. Wechseln Sie das Verzeichnis auf einer Ebene über dem Rootverzeichnis Ihres Webservers.
z.B.: cd /home/www/p1234/

4. Laden Sie sich die neuen Typo3-Sourcen auf ihren Linuxrechner. Die aktuellen Sourcen finden Sie unter: http://typo3.org/download/packages/.

Die benötigte Datei hat das Format typo3_src-3.x.x.tar.gz

'''Beispiel:'''

wget belnet.dl.sourceforge.net/sourceforge/typo3/typo3_src-3.7.0.tar.gz

5. Entpacken Sie die Datei mit dem Kommando:

'''Beispiel:'''

tar -xzvf typo3_src-3.x.x.tar.gz

6. Ändern Sie nun die Rechte so, wie der bisherige Typo3-Sourcecode-Ordner sie hatte.

'''Beispiel:'''

chown p1234.ftponly typo3_src-3.7.0 -R

7. Entfernen Sie den alten symbolischen Link mit:

rm typo3_src

8. Legen Sie nun einen neuen Link an mit:

ln -s typo3_src-3.x.x typo3_src

(Die Versionsnummer müssen Sie natürlich noch anpassen.)

9. Nun muss die Datenbank noch aktualisiert werden:

Gehen Sie hierzu in das Typo3-Installtool und klicken Sie auf den 2. Menüpunkt Database Analyser. Mit einem Klick auf Compare werden die zu ändernden oder zu ergänzenden Datenbankfelder angezeigt. Mit einem Klick auf "Write to database" wird die Datenbank an die neue Typo3-Version angepasst.

10. Loggen Sie sich nun als Admin im Backend an und löschen Sie alle Caches.

== Neu in Version 4 ==
* Conditions mit AND und OR (|| &&)

== Neu in 4.2 ==
Viele Usability Verbesserungen im Backend
== Update auf 4.2 ==
=== Extensions Updaten ===
* dam 1.0.11 ist nicht kompatibel Update auf min. 1.0.13
* date2cal auf >= 7.1.0
* Kickstarter 0.3.8 ist nicht kompatibel
* Developer tools gehen nicht mehr (wg. Frame oben)

=== Ablauf ===
* Backend Benutzer sperren (only Admins)
* Sicherung der Datenbank
* neue Source + Symlink
* Update Wizard
* Compare

=== Probleme ===
'''DAM Upload geht für Benutzer''' nicht mehr (Fehler Meta Daten können nicht geschrieben werden)
Beim neu indizieren geht dem dam der Media Ordner verloren. Er legt dann einen neuen an, in den er scheiben möchte. Die Benutzer sind abe noch auf den alten eingestellt. D.h. die Benutzergruppen m´üssen auf den neuen eingestellt werden.

Im Dam stehen im IE7 die Benutzerwerkzeuge nicht zur verfügung (löschen etc.) nur der Stift ist noch da.

Lösung: Das Problem ist das CSS für das Fenster. Es verdeckt die restlichen Symbole
Forum: 24.7.

Ich hatte das gleiche Problem bis vor 5 Minuten auch,
gelöst habe ich es so:
- Datei: class.tx_dam_listbase.php im Ordner DAM\lib\
Unter der Zeile 256 ('itemTD' => ' class="typo3-dblist-item"',)
ist in 3 Werten als Breite 1% angegeben. Das auskommentieren

- Datei: stylesheet.cdd in typo3_src\typo3\
table.typo3-dblist width: 98%; durch width: auto; ersetzen und in
table.typo3-dblist tr td {width: auto;} einsetzen,

damit hats bei mir im IE 7, Firefox, safari für Win und Opera alles richtig angezeigt :-)

Ich hoffe, geholrfen zu haben,
Schmoozer

Bug in Mount Points

== Datenbank über Root Shell sichern (mysql backup) ==

mysqldump -opt ...

Beispiele

Die häufigste Anwendung von mysqldump ist wahrscheinlich die '''Erstellung eines Backups einer vollständigen Datenbank''':

shell> mysqldump --opt db_name > backup-file.sql

oder mit User und Passwortangabe:
mysqldump -u meinDBUser -pGEHEIM db_name > backup.sql

--opt ist in neueren MySQL Versionen Standardmäßig an deshalb lassen wir es mal weg.

Die Speicherauszugsdatei können Sie wie folgt '''wieder einspielen'''.

shell> mysql db_name < backup-file.sql

Oder aber so:

shell> mysql -e "source /path-to-backup/backup-file.sql" db_name

mysqldump ist ferner sehr nützlich zum Ausfüllen von Datenbanken durch Kopieren von Daten von einem MySQL Server auf einen anderen:

shell> mysqldump --opt db_name | mysql --host=remote_host -C db_name

Sie können mit einem einzigen Befehl einen Speicherauszug mehrerer Datenbanken erstellen:

shell> mysqldump --databases db_name1 [db_name2 ...] > my_databases.sql

Um einen Speicherauszug aller Datenbanken zu erstellen, verwenden Sie die Option --all-databases:

shell> mysqldump --all-databases > all_databases.sql

Bei InnoDB-Tabellen bietet mysqldump die Möglichkeit, eine Online-Sicherung zu erstellen:

shell> mysqldump --all-databases --single-transaction > all_databases.sql

Diese Datensicherung muss vor Beginn des Speicherauszugsvorgangs lediglich (mit FLUSH TABLES WITH READ LOCK) eine globale Lesesperre für alle Tabellen erwirken. Sobald diese Sperre aktiv ist, werden die Koordinaten des Binärlogs ausgelesen, und die Sperre wird aufgehoben. Wenn beim Absetzen der FLUSH-Anweisung gerade eine umfangreiche Änderungsanweisung ausgeführt wird, dann – und nur dann! – kann der MySQL Server stehen bleiben, bis diese lange Anweisung ausgeführt ist; danach ist der Server sperrfrei. Wenn die vom MySQL Server empfangenen Änderungsanweisungen (in Bezug auf ihre Ausführungsdauer) kurz sind, sollte die anfängliche Sperrperiode auch bei vielen Änderungen nicht spürbar sein.

Bei der Point-in-Time-Wiederherstellung (die auch als „Roll-Forward“ bezeichnet wird, wenn Sie ein altes Backup wiederherstellen und die seitdem durchgeführten Änderungen neu aufspielen müssen) ist es häufig nützlich, das Binärlog zu rotieren (siehe Abschnitt 5.12.3, „Die binäre Update-Logdatei“) oder zumindest die Binärlogkoordinaten zu kennen, denen der Speicherauszug entspricht:

shell> mysqldump --all-databases --master-data=2 > all_databases.sql

Oder:

shell> mysqldump --all-databases --flush-logs --master-data=2
> all_databases.sql

== Mass Update Script ==

Yesterday some updates came out for TYPO3. These updates fixed certain issues and we needed to update all of our excellent shared hosting environments.

We already have a script (which is more elaborate now) that checks all our TYPO3 installations and sends the sysadmins a nice report about its findings. We use part of that report (list of paths to Document Roots) to feed the updater script.

The TYPO3 update requires you to do the followi

* update encryption key
* clear configuration cache
* clear page cache

We do not want to go into 200+ TYPO3 backends and do those tasks manually. We are lazy and we will write a script to automagically do the boring tasks for us.

This script is not perfect but it works well on Debian systems. You can modify it to fit your needs. It was just a quick hack to ease the upgrade pain. Take care to switch the symlink part for upgrade runs of different versions of TYPO3.

I am not responsible for any damage to your system that may occur to misuse of this script. Make sure you understand it before you run it. Run it with a single URI before attempting a whole ist of URI's.

Ein Massen Update Script von:

http://typofree.org/article/archive/2009/january/title/typo3-mass-upgrade-script/
Zugriff am 12.3.2009

http://typofree.org/article/archive/2009/january/title/typo3-mass-upgrade-script/

TYPO3 mass update script

1.
#!/bin/sh
2.
binDir=/usr/bin/
3.
sleep=2
4.

5.
pageCacheTables=(
6.
cache_pages
7.
cache_pagesection
8.
)
9.

10.
sites=(
11.
/var/www/sites/live/www.somedomain.tld
12.
/var/www/sites/live/www.someotherdomain.tld
13.
/var/www/sites/live/www.yetsomeotherdomain.tld
14.
)
15.

16.
len=${#sites[*]}
17.
pageCacheTablesLength=${#pageCacheTables[*]}
18.
i=0
19.
while [ $i -lt $len ]; do
20.
echo updating: ${sites[$i]}
21.
cd ${sites[$i]}
22.
rm typo3_src
23.
ln -s ../../sources/typo3_src-4.2.5 typo3_src
24.

25.
echo generating new key
26.
k=0
27.
key=''
28.
while [ $k -lt 96 ]; do
29.
key=$key$(head -100 /dev/urandom | md5sum | cut -c1)
30.
let k++
31.
done
32.
echo key: $key
33.
sed -i "s/$\$TYPO3_CONF_VARS\['SYS']\['encryptionKey'] = $.*/\1'$key';/g" typo3conf/localconf.php
34.

35.
echo removing configuration cache
36.
rm -f typo3conf/temp_CACHED*
37.

38.
echo clearing page cache
39.
# For some insane reason some values are enclosed in double qotes
40.
database=$(grep "typo_db " typo3conf/localconf.php | tail -1 | sed "s/^[^']*'$[^']*$'.*/\1/" | grep '$typo_db =')
41.
if [ -z "$database" ] ; then
42.
database=$(grep "typo_db " typo3conf/localconf.php | tail -1 | sed "s/^[^']*'$[^']*$'.*/\1/")
43.
else
44.
database=$(grep "typo_db " typo3conf/localconf.php | tail -1 | sed "s/^[^\"]*\"$[^\"]*$\".*/\1/")
45.
fi
46.
username=$(grep "typo_db_username " typo3conf/localconf.php | tail -1 | sed "s/^[^']*'$[^']*$'.*/\1/" | grep '$typo_db_username =')
47.
if [ -z "$username" ] ; then
48.
username=$(grep "typo_db_username " typo3conf/localconf.php | tail -1 | sed "s/^[^']*'$[^']*$'.*/\1/")
49.
else
50.
username=$(grep "typo_db_username " typo3conf/localconf.php | tail -1 | sed "s/^[^\"]*\"$[^\"]*$\".*/\1/")
51.
fi
52.
password=$(grep "typo_db_password " typo3conf/localconf.php | tail -1 | sed "s/^[^']*'$[^']*$'.*/\1/" | grep '$typo_db_password =')
53.
if [ -z "$password" ] ; then
54.
password=$(grep "typo_db_password " typo3conf/localconf.php | tail -1 | sed "s/^[^']*'$[^']*$'.*/\1/")
55.
else
56.
password=$(grep "typo_db_password " typo3conf/localconf.php | tail -1 | sed "s/^[^\"]*\"$[^\"]*$\".*/\1/")
57.
fi
58.
j=0
59.
while [ $j -lt $pageCacheTablesLength ];
60.
do
61.
nice -n 19 ${binDir}mysql --batch -u$username -p"$password" -D$database -e "TRUNCATE ${pageCacheTables[$j]}"
62.
nice -n 19 ${binDir}mysql --batch -u$username -p"$password" -D$database -e "ALTER TABLE ${pageCacheTables[$j]} auto_increment=1"
63.
let j++
64.
done
65.

66.
echo "done! Sleeping $sleep seconds . . ."
67.
sleep $sleep
68.

69.
echo
70.
let i++
71.
done

== Notfallhacks bei alten TYPO3 ==
=== Update auf neuere Datenbanken Fehler: character set utf8 is not used for this connection ===
'''Potentielle Probleme:'''
* TYPO3 erwartet utf8 (genauer gesagt utf8mb3)
* TYPO3 7.6 geht standardmäßig von utf8_general_ci aus. Eine neuere Datenbank verwendet aber utf8mb3_general_ci – das ist funktional fast identisch mit dem alten utf8, aber durch neuere MySQL-Versionen expliziter gemacht. Trotzdem nicht 100 % dieselbe Bezeichnung → TYPO3 könnte das als Konflikt interpretieren.
* Verbindung läuft auf utf8mb4_unicode_ci Das ist ein 4-Byte-Zeichensatz, der nicht 100% kompatibel mit utf8mb3 ist. → Bei Sortierungen oder LIKE-Abfragen könnte TYPO3 falsche Ergebnisse bekommen (z. B. bei Umlauten, Emojis, Sonderzeichen). Ist aber i.d.R. nicht die Ursache für einen Datenbankfehler.
* Server-Default ist latin1_swedish_ci Dieser Zeichensatz ist alt und wird häufig von MySQL als Fallback verwendet. Gefährlich: Wenn irgendwo keine Zeichensatzangabe erfolgt (z. B. beim Import oder bei neuen Tabellen), wird automatisch latin1 genommen – und das zerstört Umlaute.

Lösungen:
==== Tabellen prüfen ====

phpmyadmin > sql
<syntaxhighlight lang="mysql">
SHOW VARIABLES LIKE 'character_set%';
SHOW VARIABLES LIKE 'collation%';
SELECT table_name, table_collation
FROM information_schema.tables
WHERE table_schema = 'DEIN_DATENBANKNAME';
</syntaxhighlight>

Alle Tabellen sollten auf utf-8 oder utf-8 mb3 (oder mb4) stehen. Bei Bedarf umstellen:
ALTER TABLE `tabellenname` CONVERT TO CHARACTER SET utf8 COLLATE utf8_general_ci;

==== LocalConfiguration.php ====
Sicherstellen, dass utf-8 zur Übertragung verwendet wird.
<syntaxhighlight lang="php">
//...
'DB' => [
//...
'charset'=> 'utf8', // vorsichtshalber setzen
],
//...
'SYS' => [
//...
'setDBInit' => 'SET NAMES utf8', // vorsichtshalber setzen
],
</syntaxhighlight>

==== Prüfung in TYPO3 aussetzen ====
Wenn keine Möglichkeit besteht die Datenbank selbst zu beeinflussen. Kann man die problematische Prüfung in TYPO3 auskommentieren (nur als Übergang empfohlen). Unbedingt TYPO3 updaten.
/typo3_src-7.6.9/typo3/sysext/core/Classes/Database/DatabaseConnection.php
<syntaxhighlight lang="php">
/* dirty but suitable for some time
if (!$hasValidCharset) {
throw new \RuntimeException(
'It looks like the character set ' . $this->connectionCharset . ' is not used for this connection even though it is configured as connection charset. ' .
'This TYPO3 installation is using the $GLOBALS[\'TYPO3_CONF_VARS\'][\'SYS\'][\'setDBinit\'] property with the following value: "' .
$GLOBALS['TYPO3_CONF_VARS']['SYS']['setDBinit'] . '". Please make sure that this command does not overwrite the configured charset. ' .
'Please note that for the TYPO3 database everything other than utf8 is unsupported since version 4.7.',
1389697515
);
} */
</syntaxhighlight>

TYPO3-Cache leeren (Install Tool oder /typo3temp/Cache/*)

ProcessWire - TinyMCE Editor

2025-08-04T17:50:49Z

109.193.152.88: /* Divs erlauben mittels Plugin */

Der TinyMCE Editor ist der Nachfolger des CKE Editor. Er läßt sich deutlich leichter modifizieren.

Styles lassen sich in den Moduleinstellungen anpassen (Custom style formats CSS). Das geht auf Modulebene oder auf Feldebene (wenn man das in den Moduleinstellungen erlaubt):

Beispiel
<pre>
#Extras h5.accordion { } /* Accordion item heading */
#Extras h6 { } /* Tab item heading */
#Extras hr.stop { } /* Stop tabs or accordions */
#Blocks uk-text-lead {font-size: 1.5em } /* Lead text */
#Blocks .uk-text-meta { font-size: 14px; color: #999 } /* Meta text */
#Blocks .uk-text-small { font-size: 14px; } /* Small text */ #Uikit .uk-text-muted { color: #999; } /* Muted text */
#Inline span.red-text { color: red; } /* Red Text */
#Blocks p.outline { padding: 20px; border: 1px dotted #ccc; } /* Outline paragraph
</pre>

Wobei #Blocks für den Menübereich steht und der Kommentar für das /* Label */

== Divs erlauben mittels Plugin ==
Wenn man divs nutzen will gibt es einige Fallen. Z.B. ist es nicht so einfach mehrere p-Tags innerhalb eines Divs zu nutzen. Man kann aber z.B. ein TinyMce Plugin basteln.

Mit diesem Div kannst du per Button einen Bereich im Editor mit einem DIV umschließen. Danach funktionieren auch div.meinstyle Elemente die man als Blockelemente (wie oben gezeigt) definiert.

=== Plugin Code ===
<syntaxhighlight lang="javascript">
/**
* “wdiv” (wrap selected content with a div) plugin
* for TinyMCE 6 in processwire (what eles?)
*/

tinymce.PluginManager.add('wdiv', (editor, url) => {
const openDialog = () => editor.windowManager.open({
title: 'wdiv plugin',
body: {
type: 'panel',
items: [
{
type: 'input',
name: 'ziclass',
label: 'css class to use'
}
]
},
buttons: [
{
type: 'cancel',
text: 'Close'
},
{
type: 'submit',
text: 'Save',
buttonType: 'primary'
}
],
onSubmit: (api) => {
const data = api.getData();
/* wrap the selected text/html with a div having a class */
let cnt = editor.selection.getContent({format: 'html'});
if(data.ziclass != '') {
editor.insertContent(`<div class="${data.ziclass}">${cnt}</div>`);
}
else {
editor.insertContent(`<div class="box">${cnt}</div>`);
}
api.close();
}
});
editor.ui.registry.addIcon('divcode', '<svg height="24" width="24" viewBox="0 0 24 24"><path d="M12.89,3L14.85,3.4L11.11,21L9.15,20.6L12.89,3M19.59,12L16,8.41V5.58L22.42,12L16,18.41V15.58L19.59,12M1.58,12L8,5.58V8.41L4.41,12L8,15.58V18.41L1.58,12Z" /></svg>');
editor.ui.registry.addButton('wdiv', {
text: 'wdiv',
icon: 'divcode',
tooltip: "wrap with a div",
onAction: () => {
/* Open dialog window */
openDialog();
}
});
// metadata
return {
getMetadata: () => ({ name: 'Wdiv' })
};
});

</syntaxhighlight>

* Pfad zum Plugin unter external Plugins in den Moduleinstellungen eingeben z.B.
/site/templates/modules/TinyMcePlugins/pw-tinymce-div-plugin-main/wdiv.js
* Plugin kann jetzt in den Feldeinstellungen aktivieret werden.
* Button zum Menü hinzufügen, mit dem Kürzel wie das Plugin heißt (hier wdiv)

ProcessWire - TinyMCE Editor

2025-08-04T17:49:04Z

109.193.152.88:

Der TinyMCE Editor ist der Nachfolger des CKE Editor. Er läßt sich deutlich leichter modifizieren.

Styles lassen sich in den Moduleinstellungen anpassen (Custom style formats CSS). Das geht auf Modulebene oder auf Feldebene (wenn man das in den Moduleinstellungen erlaubt):

Beispiel
<pre>
#Extras h5.accordion { } /* Accordion item heading */
#Extras h6 { } /* Tab item heading */
#Extras hr.stop { } /* Stop tabs or accordions */
#Blocks uk-text-lead {font-size: 1.5em } /* Lead text */
#Blocks .uk-text-meta { font-size: 14px; color: #999 } /* Meta text */
#Blocks .uk-text-small { font-size: 14px; } /* Small text */ #Uikit .uk-text-muted { color: #999; } /* Muted text */
#Inline span.red-text { color: red; } /* Red Text */
#Blocks p.outline { padding: 20px; border: 1px dotted #ccc; } /* Outline paragraph
</pre>

Wobei #Blocks für den Menübereich steht und der Kommentar für das /* Label */

== Divs erlauben mittels Plugin ==
Wenn man divs nutzen will gibt es einige Fallen. Z.B. ist es nicht so einfach mehrere p-Tags innerhalb eines Divs zu nutzen. Man kann aber z.B. ein TinyMce Plugin basteln.

=== Plugin Code ===
<syntaxhighlight lang="javascript">
/**
* “wdiv” (wrap selected content with a div) plugin
* for TinyMCE 6 in processwire (what eles?)
*/

tinymce.PluginManager.add('wdiv', (editor, url) => {
const openDialog = () => editor.windowManager.open({
title: 'wdiv plugin',
body: {
type: 'panel',
items: [
{
type: 'input',
name: 'ziclass',
label: 'css class to use'
}
]
},
buttons: [
{
type: 'cancel',
text: 'Close'
},
{
type: 'submit',
text: 'Save',
buttonType: 'primary'
}
],
onSubmit: (api) => {
const data = api.getData();
/* wrap the selected text/html with a div having a class */
let cnt = editor.selection.getContent({format: 'html'});
if(data.ziclass != '') {
editor.insertContent(`<div class="${data.ziclass}">${cnt}</div>`);
}
else {
editor.insertContent(`<div class="box">${cnt}</div>`);
}
api.close();
}
});
editor.ui.registry.addIcon('divcode', '<svg height="24" width="24" viewBox="0 0 24 24"><path d="M12.89,3L14.85,3.4L11.11,21L9.15,20.6L12.89,3M19.59,12L16,8.41V5.58L22.42,12L16,18.41V15.58L19.59,12M1.58,12L8,5.58V8.41L4.41,12L8,15.58V18.41L1.58,12Z" /></svg>');
editor.ui.registry.addButton('wdiv', {
text: 'wdiv',
icon: 'divcode',
tooltip: "wrap with a div",
onAction: () => {
/* Open dialog window */
openDialog();
}
});
// metadata
return {
getMetadata: () => ({ name: 'Wdiv' })
};
});

</syntaxhighlight>

* Pfad zum Plugin unter external Plugins in den Moduleinstellungen eingeben z.B.
/site/templates/modules/TinyMcePlugins/pw-tinymce-div-plugin-main/wdiv.js
* Plugin kann jetzt in den Feldeinstellungen aktivieret werden.
* Button zum Menü hinzufügen, mit dem Kürzel wie das Plugin heißt (hier wdiv)

Google Rezensionen / Google Reviews

2025-07-11T10:18:28Z

109.193.152.88:

== Quickstart ==
Hier geht es darum wie man Google Reviews verarbeiten und nutzen kann.

===Auslesen von Rezensionen===
* geht entweder über die Business Profile Performance API (nur die eigenen, aber kostenlos).
* Google Places API (kostenpflichtig ab gewisser Abrufzahl). Caching wichtig damit es nicht teuer wird.

Google Rezensionen / Google Reviews

2025-07-11T10:17:23Z

109.193.152.88: Die Seite wurde neu angelegt: „Quickstart Auslesen von Rezensionen * geht entweder über die Business Profile Performance API (nur die eigenen, aber kostenlos). * Google Places API (kosten…“

Quickstart

Auslesen von Rezensionen
* geht entweder über die Business Profile Performance API (nur die eigenen, aber kostenlos).
* Google Places API (kostenpflichtig ab gewisser Abrufzahl). Caching wichtig damit es nicht teuer wird.

Google

2025-07-11T10:12:32Z

109.193.152.88:

[[Google Tagmanager]]
[[PrivacyWire - ProcessWire Modul|Google Consent v2 - ProcessWire PrivacyWire Modul]]
[[Google Conversion-Tracking]]
[[Google AdWords]] - Veraltet
[[Google Maps]]
[[Google Maps - DSGVO und Nutzungsvereinbarungen]]
[[Google Analytics]]
[[Google Maps - Snippets]]
[[Google PlayStore]]
[[Google PlayStore - App Release]]
[[Google Conversion-Tracking]]
[[Google Jobs]]
[[Google Rezensionen / Google Reviews]]

ProcessWire - Selectors

2025-06-17T07:15:34Z

109.193.152.88: /* Beispiele */

== Operatoren ==
http://cheatsheet.processwire.com/selectors/selector-operators/
Selector Operators

=
Equal to (any_field=any_value)

!=
Not equal to (any_field!=any_value)

<
Less than (any_field

>
Greater than any_field>any_value

<=
Less than or equal to (any_field<=any_value)

>=
Greater than or equal to (any_field>=any_value)

*=
Contains the exact word or phrase (any_field*=any_value)

~=
Contains all the words (any_field~=any_value)

%=
Contains the exact word or phrase (using slower SQL LIKE) [v2.1] (any_field%=any_value)

^=
Contains the exact word or phrase at the beginning of the field [v2.1] (any_field^=any_value)

$=
Contains the exact word or phrase at the end of the field [v2.1] (any_field$=any_value)

=== Neue Operatoren ab 3.0.160 ===
List of new operators available as of ProcessWire 3.0.160

Here's a list of new operators available as of 3.0.160, along with brief explanation of what each operator does and how it differs from other similar operators.

Contains words partial (~*=)
Like existing match words (~=) operator, except that this one matches partial words as well.

Contains words live (~~=)
Like match words, except that the last word in the query is treated as a partial match.

Contains words like (~%=)
Matches all words in the query, in full or in part.

Contains words and expand (~+=)
Like match words operator, but with the added power of the query expansion feature supported by MySQL fulltext indexes.

Contains any words (~|=)
One or more of the words must match; this is similar to splitting the query with pipe (|) characters, but often easier to use, and better optimized.

Contains any partial words (~|*=)
Similar to the previous operator, except that this one also provides partial matches.

Contains any words like (~|%=)
Similar to the previous two operators, but uses LIKE query behind the scenes instead of the fulltext index.

Contains phrase and expand (*+=)
Variation of the phrase match operator (*=) with added query expansion support.

Contains match (**=)
This operator works much like the MATCH/AGAINST feature of MySQL fulltext indexes.

Contains match and expand (**+=)
Otherwise identical to previous operator, except for the added query expansion.

Advanced text search (#=)
This operator adds support for special characters, such as "+" for "must match", "-" for "must not match", and "*" for specifying partial matches.

== Owner Attribut ==
Nützlich bei '''Pagereferences''', wenn '''auf die Seite verweisende Seiten''' gefunden und '''gleichzeitig gefiltert''' werden sollen.
https://processwire.com/blog/posts/processwire-3.0.95-core-updates/
<syntaxhighlight lang="php">
$members = $pages->find("template=member, age>50");
foreach($members as $m) {
$items = $m->memberships->find("club='Golf Club X', mtype=GOLD");
foreach($items as $membership) {
// add to excel or other export, etc.
}
}
</syntaxhighlight>
Ineffektiv bei vielen Datensätzen ->
<syntaxhighlight lang="php">
$items = $pages->find("club='Golf Club X', mtype=GOLD, memberships.owner.age>50");
foreach($items as $membership) {
// add to excel or other export, etc.
}
</syntaxhighlight>

== Kombinierte Abfragen und Subselektoren ==
Da man auch Seiten im Selektor übergeben kann, kann man relativ einfach kombinierte Abfragen über '''mehrere Templates''', oder auch über '''parents''' etc. machen. Mit Subselektoren kann man das noch abkürzen.

'''Kombinierte Abfrage'''
<pre>
$companies = $pages->find("template=company, locations>5, locations.title%=Finland");
$items = $pages->find("template=product, company=$companies");
</pre>
'''Mit Subselektoren'''
$items = $pages->find("template=product, company=[locations>5, locations.title%=Finland]");

== OR / AND ==
OR funktioniert über

'''Feldwert a oder Feldwert b'''
firstname=Mike|Steve

'''Feldwert a und Feldwert b'''
height>500, height<=1000

'''In Feld a oder in Feld b'''
body|sidebar*=carbonated

=== OR Groups ===
'''(Bedingung a, Bedingung b),(Bedingung c)'''
Wenn man Klammern nutzt muss nur eine der Klammern zutreffen.

Beispiel "product" Seiten in stock, UND entweder in featured date range, ODER highlighted checkbox checked.

<syntaxhighlight lang="php">
$items = $pages->find("template=product, stock>0, (featured_from<=today, featured_to>=today), (highlighted=1)");
</syntaxhighlight>
Die Klammern kennzeichnen Optionale Bedingungen. '''Es muss also nur eine der Klammern zutreffen.'''

Wenn man mehrere Oder-Gruppen benötigt kann man so vorgehen:
foo=(selector1), bar=(selector2), foo=(selector3), bar=(selector4)
Hier gehören alle foo zusammen und alle bar. Sprich es muss '''selector1 ODER selector3 UND selector2 ODER selector4''' erfüllt sein.

https://processwire.com/docs/selectors/#or-selectors1

=== Selektoren und RepeaterMatrix ===
'''Beispiel TV Altötting'''
<syntaxhighlight lang="php">
//BEISPIEL: $results = $pages->find("template=matrix_page,matrix_main.body%=$q"); // name des matrix items weglassen
//$selector = "template=".implode('|',$pageTemplates).", layout_blocks.body~*=".$val; // findet einspalter aber keine in
//$selector = "template=".implode('|',$pageTemplates).", layout_blocks.r_grid.body~*=".$val; // findet mehrspalter aber keine einspalter
// dot notation not allowed with or so we have to use or groups or bracket notation:
$selector = "template=".implode('|',$pageTemplates).", (layout_blocks.body~*=".$val."),(layout_blocks.text~*=".$val."),(layout_blocks.headline~*=".$val."),(layout_blocks.r_grid.body~*=".$val.")"; // findet mehrspalter aber keine einspalter
bd($selector,"selector for content");
$matches = $pages->find($selector);

$searchResultMarkup .= "<h5>Suche im Seiteninhalt [$matches->count]</h5>";
if($matches->count) {
$searchResultMarkup .= renderNav($matches);
} else {
$searchResultMarkup .= "<p>Keine Seiteninhalte mit diesem Suchbegriff gefunden.</p>";
}
</syntaxhighlight>

== Anzahl beschränken mit limit und start ==
limit=50 // 50 or fewer results
start=50, limit=50 //50 (or less) results starting at the 51st (results 51–100).

If you are using a limit selector with pages, and your template has page-numbers (pagination) turned on, ProcessWire will automatically set the "start" selector according to the current page/pagination number. So when it comes to pagination, you don't usually have to think about anything other than the "limit" selector.

== Array Selectors ==
https://processwire.com/blog/posts/processwire-3.0.13-selector-upgrades-and-new-form-builder-version/#building-a-selector-string-with-user-input-example

=== Selektoren als assoziative Arrays ===

Anstatt von Selector Strings kann man seit PW 3.0.13 auch Arrays nutzen.:d of a string:
<syntaxhighlight lang="php">
$results = $pages->find([
'template' => ['basic-page', 'product'],
'title|body%=' => $sanitizer->text($input->get('q')),
'categories' => $sanitizer->intArray($input->get('categories')),
'sort' => '-created'
]);
</syntaxhighlight>
Erläuterung:

Die ''$sanitizer->selectorValue()'' Methode um Text zu sanitizen der in Selektoren geht ist nicht mehr notwendig. Du solltest immer noch User Input sanitizen, aber man kann sich die sanierung für die Selektoren sparen.
Werte können Arrays sein. Im Beispiel werden Arrays für 'template' and 'categories' items genutzt.

Der "=" Operator wird für alle Selektoren Elemente angenommen, solange man nicht einen anderen Operator anhängt. Wie bei '''title|body%=''' zu sehen.

=== Selektoren als reguläre Arrays ===
Man kann auch ein reguläres (nicht assoziatives Array nutzen:
<syntaxhighlight lang="php">
$results = $pages->find([
['template', ['basic-page', 'product']],
['title|body', '%=', $input->get('q'), 'text'],
['categories', '=', $input->get('categories'), 'int'],
['sort', '-created']
]);
</syntaxhighlight>
Hier werden die Selektorenteile als Array im Array übergeben. Das Format ist folgendes:f those arrays can use any of the following formats:
<pre>
[field, value]
[field, operator, value]
[field, operator, value, sanitizer]
[field, operator, value, whitelist]
</pre>

* The field element can be specified as a single field name, pipe "|" separated field names, or an array of field name(s).
* The operator can be any operator. If none is specified, then equals "=" is assumed (which you can do if only specifying a field and value).
* The value can be a string, number or array of either.
* The sanitizer can be any $sanitizer method name that you want the value to pass through before being used in the selector.
* When a whitelist (array) is specified for the sanitizer, the selector will throw an Exception if the given value (or values) are not present in the whitelist array.

Beide Array Formate (assoziativ, regulär) kann man theoretisch sogar mischen.

== Owner Selector ==
https://processwire.com/blog/posts/processwire-3.0.95-core-updates/
Mit Owner Selektoren kannst du Verknüpfungen die über PageTable pages, Page fields oder Repeater fields realisiert werden effizient durchsuchen, ohne Schleifen zu benutzen.

Es dauert etwas bis man das Konzept verstanden hat aber es ist extrem effektiv.

Eine zeitaufwändige Suche über eine Schleife wie diese:
<syntaxhighlight lang="php">
$members = $pages->find("template=member, age>50");
foreach($members as $m) {
$items = $m->memberships->find("club='Golf Club X', mtype=GOLD");
foreach($items as $membership) {
// add to excel or other export, etc.
}
}
</syntaxhighlight>
wird dann einfach zu:
<syntaxhighlight lang="php">
$items = $pages->find("club='Golf Club X', mtype=GOLD, memberships.owner.age>50");
foreach($items as $membership) {
// add to excel or other export, etc.
}
</syntaxhighlight>
Anstatt über template=member zuerst alle Members zu durchlaufen und diese dann weiter nach Mitgliedschaften zu filtern geht man den Weg anders herum. Man nimmt das Feld das man sucht und schaut über den owner Selector wo es überall Referenziert wird. Also eine Art Rückwärtssuche.

== Beispiele ==
=== Datum ===
Per Default nutzt PW das Datum als Timestamp. Um z.B. alle

For recieving page of today, you would have to create a start and end time range and use them in the selector.
<syntaxhighlight lang="php">
$start = strtotime( date('Y-m-d') . " 00:00:00");
$end = strtotime( date('Y-m-d') . " 23:59:59");
$items = $pages->find("template=linkmain,publishdate>=$start,publishdate<=$end,sort=-userid");
</syntaxhighlight>

Beispiel
<syntaxhighlight lang="php">
$startDate = '2023-01-01';
$endDate = '2023-03-31';
$start = $startDate . ' 00:00:00';
$end = $endDate . ' 23:59:59';
$paidInvoices = pages("template=invoice, invoice_paid=1, invoice_date>=$start, invoice_date<=$end");
</syntaxhighlight>
Todo Beispiele mit wire()-> Datumsfunktionen

=== Parents ===
To specify that matches should have a '''specific parent''', specify the parent's path, object or ID. First is an example of using the parent's path:
https://processwire.com/docs/selectors/#finding2
parent=/path/to/parent/
parent=$parent
parent=123
parent=$parent1|$parent2|$parent3

==== Parents bei Repeatern oder RepeaterMatrix ====
https://wiki.stephanschlegel.de/index.php?title=ProcessWire_-_Snippets#Parent_von_Repeater_oder_RepeaterMatrix_finden

=== Sortiere Seiten nach Reihenfolge im Seitenbaum ===
Das funktioniert mit der Sortierung "sort".
$categories = pages('template=template_name,sort=sort');
=== Große Datenmenge mit findMany() durchsuchen ===
[[findMany() - ProcessWire API]]

=== Suche nach Seiten die Verweise auf bestimmte andere Seiten enthalten ===
https://processwire.com/talk/topic/5414-selector-find-page-reference-help/

Es sollen Seiten gefunden werden die mit einer Page Reference auf eine andere Seite verweisen. Am einfachsten geht das wenn man nicht wie man zuerst vermutet nach der Seiten ID sucht, sondern wenn man direkt nach der Seite sucht
team_name=$page

=== Suche nach Phrasen in Daten die in Seitenverweise enthalten sind ===
https://processwire.com/talk/topic/570-searching-page-reference-fields/

Es sollen Seiten gefunden werden, die Verweise auf andere Seiten enthalten. Beispielsweise enthalten Personen (Eltern) Links zu Notfalladressen die separat angelegt sind. Nun soll Nach Eltern gesucht werden, die eine bestimmte Notfalladresse enthalten. Gesucht wird nach einer Phrase im Notfalladrdessen Namen).

Lösung: Es wird in zwei Schritten gesucht.

1. Suche nach Kontakten mit dem Search Term im body und die dem template emergency-contact entsprechen
$contacts = $pages->find("body*='search term', template=emergency-contact");
2. Seiten die diesen Kontakten entsprechen
$parents = $pages->find("emergency-contacts=$contacts");

=== Selektoren in Option Fieldtypes ===
<syntaxhighlight lang="php">
$optionsfield // return id (string)
$optionsfield->id; // return id (int)
$optionsfield->title; // return string USE THIS or
$optionsfield->value; // return empty string or value (if your option settings like '1=value|title')

// dot syntax in selector string
$pages->find('optionsfield.id=2');
</syntaxhighlight>

=== Selektoren für Multiple Options ===

==== Finde Seiten in gewählten Optionen ====
Nehmen wir an wir haben Seiten mit dem Template tag und ein Template product, das wiederum ein PageReference Feld 'tags' hat bei dem man ein oder mehrere Tags auswählen kann.

1. Seiten die eines oder mehr der gewählten Tags haben.
<syntaxhighlight lang="php">
$myTags = array();
// find product pages which fit all options
$tags = array();
foreach($page->tag_selector as $tag) {
$tags[] = $tag->name;
}
$items = $items->find('template=product,tags.name=' . implode('|',$tags) );
//bd($items);
</syntaxhighlight>
2. Seiten die alle gewählten Tags haben oder mindestens einen (mit Schalter)
<syntaxhighlight lang="php">
$or = $page->opt_1;
if(count($page->tag_selector)){
$myTags = array();
$tags = array();
foreach($page->tag_selector as $tag) {
if ($or) $tags[] = $tag->name;
else $tags[] = 'tag.name='.$tag->name;
}
if ($or) $items = pages()->find('template=product,tags.name=' . implode('|',$tags) ); //OR
else $items = pages()->find('template=product,'.implode(',',$tags)); // AND
bd($items);
</syntaxhighlight>

=== Seiten finden ===
<syntaxhighlight lang="php">
$skyscrapers = $pages->find("template=skyscraper, sort=-modified");
foreach($skyscrapers as $skyscraper) {
echo "<li><a href='$skyscraper->url'>$skyscraper->title</a></li>";
}
</syntaxhighlight>

==== Rekursiv suchen ====
$pages->find("parent={$cat->children}, limit=$limit, sort=-date, sort=title"); // expands to something like "parent=1234|1235|1236|1237|...|1507|1508"

=== Page Reference auf diese Seite ===
https://processwire.com/talk/topic/1071-page-fieldtype-two-way-relation/
echo $pages->find("field1=$page")->render();
If the page isn't part of the front-end site, then I'll remove view access from its template. Or if it is part of the front-end, but I don't want to show the relations, then this:

if($page->editable()) echo $pages->find("field1=$page")->render();

Though I almost always integrate these relation-revealing pages into the site structure, as it's rare that this information doesn't have some value to the site's users too. This is an example of one that locates all pages referencing it in a field called 'country':
https://www.tripsite.com/countries/croatia/

=== Suche in PageReference Feldern ===
Generell gilt PageReferences verhalten sich gleich wie wenn man auf ein Page-Object zugreifen würde.
https://processwire.com/talk/topic/1224-selector-and-page-reference-field/

'''Beispiel:''' Finde alle Point of Interest Seiten die eine Referenz auf die Kategorie "Zoo" haben
* Template '''poi''' (Point of Interest)
** Feld '''poi_type''' (PageReference) referenziert auf Seiten mit dem Template type
* Template '''type'''

Der Filter
$poi = $pages->find(template=poi, poi_type.title='Zoo');
Funktioniert nicht!

Stattdessen
# holt man zuerst alle type-Seiten mit dem Titel Zoo
# Dieses PageArray kann man direkt als Filter für eine Suche in den POIs nutzen.

<syntaxhighlight lang="php">
$pr = $pages->get("title=Zoo");
$poi = $pages->find("template=poi, poi_type=$pr");
</syntaxhighlight>

'''Beispiel 2'''
<syntaxhighlight lang="php">
$prs = $pages->find("title=Zoo|Themepark|Museum"); // maybe also use the name or id
$poi = $pages->find("template=poi, poi_type=$prs");
</syntaxhighlight>

ACHTUNG Hier ist es wichtig im ersten Selektor find zu verwenden. Get würde nur den ersten Treffer ausspucken, während find ein PageArray mit allen Ergebnissen zurückgibt.

'''Beispiel 3'''
<syntaxhighlight lang="php">
$invoicesNotSent = $pages->find('template=invoice,invoice_sent=false');
$selector = "template=order,(invoice=$invoicesNotSent),(padinvoice=)";
$ordersWithoutInvoiceOrInvoiceNotSent = $pages->find( $selector );
</syntaxhighlight>

=== Punkt Syntax ===
$architects = $pages->find("template=architect, city.title=Chicago");
$buildings = $pages->find("architect=$architects");
That's easy enough, but wouldn't it be nicer if you could just do this?
$buildings = $pages->find("architect.city.title=Chicago");

$buildings = $pages->find("architect.city.state.abbr=IL");
Broadening further, perhaps we want buildings from all architects in the USA:

$buildings = $pages->find("architect.city.state.country.abbr=USA");
Or perhaps both USA and Canada:

$buildings = $pages->find("architect.city.state.country.abbr=USA|CA");

=== User ===
http://cheatsheet.processwire.com/users/users-methods/users-find-selector/
Find all users whose email address ENDS with processwire.com and create a link to email them
<pre>
$items = $users->find("email$=processwire.com");
foreach($items as $item) {
echo "<li><a href='mailto:{$item->email}'>{$item->name}</a></li>";
}
</pre>
Find all users who have "fred" anywhere in their name

$items = $users->find("name*=fred");
Find all users who have the "superuser" role

$items = $users->find("roles=superuser");

=== Suche alle Kinder / alle Elternseiten ===
<syntaxhighlight lang="php">

/**
* get children categories for a category for a product
*
* Page $p category page
* int $maxDepth
*/
function getChildren($p, $maxDepth=3){
$children = new PageArray;
$children->add($p); // add parent category
if ($p->hasChildren() && $maxDepth > 1){
$children->add( $p->children('template=category') );
foreach($p->children as $c){
$grandchildren = getChildren($c, $maxDepth-1);
$children->add($grandchildren);
}
$children->sort('title');
return $children;
}else return false;
}

/**
* get filter Categories for a item this includes all parent categories
* @return string use as class for the isotope item
* */
function getFilters($item,$prefix='cat'){
// we need to fetch $item categories + parent categories
$filters = array();
$allCategories = new Pagearray;
$categories = $item->categories;
// for each category add category + parent categories to allCategories
foreach($categories as $category){
$allCategories->add( $category );
$allCategories->add( $category->parents('template=category') );
}
foreach($allCategories as $c){
$filters[]= $prefix.$c->id;
}
return implode(' ',$filters);
}
</syntaxhighlight>

=== Schneller CSV-Export von Selector-Ergebnissen ===
ProcessWire - schneller CSV-Export

DKIM

2025-05-19T10:50:50Z

109.193.152.88: /* DKIM bei Microsoft365 einrichten (externe Domain) */

Ein Public - Private Key Verfahren zur Verschlüsselung von E-Mail Hadern

Siehe auch

https://de.wikipedia.org/wiki/Amavis

== DKIM bei Microsoft365 einrichten (externe Domain) ==
Beispiel:

Defender Portal > Policies & rules > Threat policies > Email authentication settings

CName Einträge wie angezeigt setzen z.B.

Host Name : selector1._domainkey
Points to address or value: selector1-bauartmassivbau-de01e._domainkey.BauArtMassivbau.n-v1.dkim.mail.microsoft

Host Name : selector2._domainkey
Points to address or value: selector2-bauartmassivbau-de01e._domainkey.BauArtMassivbau.n-v1.dkim.mail.microsoft

Bedeutet z.B. bei all-inkl:

2 CNAME Einträge in DNS Einstellungen anlegen:

Host Name : selector1._domainkey
Value: selector1-bauartmassivbau-de01e._domainkey.BauArtMassivbau.n-v1.dkim.mail.microsoft

Host Name : selector2._domainkey
Value: selector2-bauartmassivbau-de01e._domainkey.BauArtMassivbau.n-v1.dkim.mail.microsoft

DKIM

2025-05-19T10:50:32Z

109.193.152.88:

Ein Public - Private Key Verfahren zur Verschlüsselung von E-Mail Hadern

Siehe auch

https://de.wikipedia.org/wiki/Amavis

== DKIM bei Microsoft365 einrichten (externe Domain) ==
Beispiel:

Defender Portal > Policies & rules > Threat policies > Email authentication settings

CName Einträge wie angezeigt setzen z.B.

Host Name : selector1._domainkey
Points to address or value: selector1-bauartmassivbau-de01e._domainkey.BauArtMassivbau.n-v1.dkim.mail.microsoft

Host Name : selector2._domainkey
Points to address or value: selector2-bauartmassivbau-de01e._domainkey.BauArtMassivbau.n-v1.dkim.mail.microsoft

Bedeutet z.B. bei all-inkl:

2 CNAME Einträge in DNS Einstellungen anlegen:

Host Name : selector1._domainkey
Value: selector1-bauartmassivbau-de01e._domainkey.BauArtMassivbau.n-v1.dkim.mail.microsoft

Host Name : selector2._domainkey
Points to address or value: selector2-bauartmassivbau-de01e._domainkey.BauArtMassivbau.n-v1.dkim.mail.microsoft

DKIM

2025-05-19T10:12:44Z

109.193.152.88:

ProcessWire - FormBuilder (Module)

2025-04-30T12:59:31Z

109.193.152.88: /* Eigene Templates für E-Mails */

https://processwire.com/store/form-builder/

== Mails per smtp versenden ==
[[ProcessWire - WireMailSmtp (Module)]]

== CSS bei einfachem embed per iFrame anpassen ==
Einfache Lösung:
* auf Basic Output stellen
* Standard CSS von /site/templates/FormBuilder/main.css kopieren
* Neuen Pfad im Formbuilder Formular eingeben.
Nachteil, das könnte für den User zu kompliziert sein.

== Import Daten für Standard Formular ==
Hiermit kann man schnell ein Formular erstellen. Einfach in Import Feld des Formbuilder kopieren.
Einfaches Standardformular:
<pre>
{
"action": "./",
"method": "post",
"roles": {
"form-submit": [
"guest"
],
"form-list": [],
"form-edit": [],
"form-delete": [],
"entries-list": [],
"entries-edit": [],
"entries-delete": [],
"entries-page": []
},
"framework": "Basic",
"submitText": "Senden",
"successMessage": "Vielen Dank, ihre Nachricht wurde versendet.",
"errorMessage": "Entschuldigung, das Formular konnte nicht versendet werden. Bitte füllen Sie alle Pflichtfelder aus. Zur Kontaktaufnahme benötigen wir entweder Ihre E-Mail oder Ihre Telefonnummer.",
"emailSubject": "Nachricht über Ihr Kontaktformular",
"responderSubject": "Auto-Response",
"saveFlags": 2,
"emailTo": "post@stephanschlegel.de",
"emailFrom": "e_mail",
"submitText1018": "Senden",
"successMessage1018": "Vielen Dank, ihre Nachricht wurde versendet.",
"errorMessage1018": "Entschuldigung, das Formular konnte nicht versendet werden. Bitte füllen Sie alle Pflichtfelder aus.",
"frBasic_cssURL": "/site/templates/styles/forms.css",
"frFoundation_foundationURL": "/site/modules/FormBuilder/frameworks/foundation/",
"frFoundation_horizHeaderClass": "small-5 medium-3 right inline",
"frFoundation_horizContentClass": "small-7 medium-9",
"frUikit_ukURL": "/site/modules/FormBuilder/frameworks/uikit/",
"frUikit_css": "uikit.gradient.min.css",
"frUikit_horizHeaderWidth": 30,
"frAdmin_styleSet": "AdminThemeDefault/styles/main-classic.css",
"frBootstrap_bootURL": "/site/modules/FormBuilder/frameworks/bootstrap/",
"frBootstrap_bootHorizHeaderClass": "col-xs-5 col-sm-4 col-md-3",
"frBootstrap_bootHorizContentClass": "col-xs-7 col-sm-8 col-md-9",
"children": {
"name_1": {
"type": "Text",
"label": "Name",
"label1018": "Ihr Name",
"maxlength": 2048,
"requiredAttr": 1
},
"telefon": {
"type": "Text",
"label": "Telefon",
"required": 1,
"columnWidth": 50,
"label1018": "Ihre Telefonnummer",
"maxlength": 2048,
"requiredAttr": 1,
"requiredIf": "e_mail=''",
"stripTags": 1
},
"e_mail": {
"type": "Text",
"label": "E-Mail",
"required": 1,
"columnWidth": 50,
"label1018": "Ihre E-Mail",
"maxlength": 2048,
"requiredIf": "telefon=''",
"stripTags": 1
},
"ihre_nachricht": {
"type": "Textarea",
"label": "Ihre Nachricht",
"required": 1,
"label1018": "Ihre Nachricht",
"rows": 5
},
"datenschutz": {
"type": "Checkbox",
"label": "Datenschutz",
"description": "Mit meiner Kontaktaufnahme willige ich ein, dass meine Daten gespeichert und zur Bearbeitung meiner Anfrage/Kontaktaufnahme genutzt werden. Meine Daten werden niemals an Dritte weitergeleitet. Diese Einwilligung kann jederzeit widerrufen werden.",
"required": 1,
"label1018": "Datenschutz",
"description1018": "Mit meiner Kontaktaufnahme willige ich ein, dass meine Daten gespeichert und zur Bearbeitung meiner Anfrage/Kontaktaufnahme genutzt werden. Meine Daten werden niemals an Dritte weitergeleitet. Diese Einwilligung kann jederzeit widerrufen werden.",
"checkedValue": "Ich stimme zu"
}
}
}
</pre>
Mit Adresse...
<pre>
{
"roles": {
"form-submit": [
"guest"
],
"form-list": [],
"form-edit": [],
"form-delete": [],
"entries-list": [],
"entries-edit": [],
"entries-delete": [],
"entries-page": []
},
"framework": "Basic",
"submitText": "Senden",
"successMessage": "Vielen Dank, ihre Nachricht wurde versendet.",
"errorMessage": "Entschuldigung, das Formular konnte nicht versendet werden. Bitte füllen Sie alle Pflichtfelder aus. Zur Kontaktaufnahme benötigen wir entweder Ihre E-Mail oder Ihre Telefonnummer.",
"emailSubject": "Nachricht über Ihr Kontaktformular",
"responderSubject": "Auto-Response",
"saveFlags": 2,
"emailTo": "post@stephanschlegel.de",
"emailFrom": "e_mail",
"submitText1018": "Senden",
"successMessage1018": "Vielen Dank, ihre Nachricht wurde versendet.",
"errorMessage1018": "Entschuldigung, das Formular konnte nicht versendet werden. Bitte füllen Sie alle Pflichtfelder aus.",
"frBasic_cssURL": "/site/templates/styles/forms.css",
"frFoundation_foundationURL": "/site/modules/FormBuilder/frameworks/foundation/",
"frFoundation_horizHeaderClass": "small-5 medium-3 right inline",
"frFoundation_horizContentClass": "small-7 medium-9",
"frUikit_ukURL": "/site/modules/FormBuilder/frameworks/uikit/",
"frUikit_css": "uikit.gradient.min.css",
"frUikit_horizHeaderWidth": 30,
"frAdmin_styleSet": "AdminThemeDefault/styles/main-classic.css",
"frBootstrap_bootURL": "/site/modules/FormBuilder/frameworks/bootstrap/",
"frBootstrap_bootHorizHeaderClass": "col-xs-5 col-sm-4 col-md-3",
"frBootstrap_bootHorizContentClass": "col-xs-7 col-sm-8 col-md-9",
"children": {
"name_1": {
"type": "Text",
"label": "Name",
"label1018": "Ihr Name",
"maxlength": 2048,
"requiredAttr": 1
},
"telefon": {
"type": "Text",
"label": "Telefon",
"required": 1,
"columnWidth": 50,
"label1018": "Ihre Telefonnummer",
"maxlength": 2048,
"requiredAttr": 1,
"requiredIf": "e_mail=''",
"stripTags": 1
},
"e_mail": {
"type": "Text",
"label": "E-Mail",
"required": 1,
"columnWidth": 50,
"label1018": "Ihre E-Mail",
"maxlength": 2048,
"requiredIf": "telefon=''",
"stripTags": 1
},
"ihre_adresse": {
"type": "Text",
"label": "Straße",
"columnWidth": 80,
"label1018": "Straße",
"requiredAttr": 1,
"maxlength": 2048,
"size": 100
},
"hausnummer": {
"type": "Text",
"label": "Hausnr.",
"required": 1,
"columnWidth": 20,
"label1018": "Hausnr.",
"maxlength": 2048
},
"plz_ort": {
"type": "Text",
"label": "PLZ Ort",
"label1018": "PLZ Ort",
"maxlength": 2048
},
"ihre_nachricht": {
"type": "Textarea",
"label": "Ihre Nachricht",
"required": 1,
"label1018": "Ihre Nachricht",
"rows": 5,
"requiredAttr": 1
},
"datenschutz": {
"type": "Checkbox",
"label": "Datenschutz",
"description": "Mit meiner Kontaktaufnahme willige ich ein, dass meine Daten gespeichert und zur Bearbeitung meiner Anfrage/Kontaktaufnahme genutzt werden. Meine Daten werden niemals an Dritte weitergeleitet. Diese Einwilligung kann jederzeit widerrufen werden.",
"required": 1,
"label1018": "Datenschutz",
"description1018": "Mit meiner Kontaktaufnahme willige ich ein, dass meine Daten gespeichert und zur Bearbeitung meiner Anfrage/Kontaktaufnahme genutzt werden. Meine Daten werden niemals an Dritte weitergeleitet. Diese Einwilligung kann jederzeit widerrufen werden.",
"checkedValue": "1"
}
}
}
</pre>

==Tipps und Tricks für Formbuilder==
=== Weiterleitung / Redirect auf Danke Seite ===

=== DatePicker ===
==== Lokalisierung / Sprache einstellen====
Der Formbuilder nutzt das Standard InputField Datetime. Das kann man übersetzen:
https://processwire.com/talk/topic/4547-possibility-to-translate-timepicker-addon-on-datepicker/?tab=comments#comment-49746

In der folgenden datei kann man als Übersetzung den Pfad zur Lokalisierungsdatei von jQuery angeben (ist im PW mit drin).

Die Datei muss man evtl. selber anlegen (im Übersetzungstool) wenn die Indizierung sie nicht schon selbst angelegt hat.

/wire/modules/Inputfield/InputfieldDatetime/types/InputfieldDatetimeText.php
path: /wire/modules/Jquery/JqueryUI/i18n/jquery.ui.datepicker-de.js

=== Links in Checkbox-Label ===
HTML geht nicht aber Markdown funktioniert:
<pre>
Ich habe die [Datenschutzerklärung](https://fbz-vet.de/datenschutz) gelesen und willige in die dort dargestellte Verarbeitung meiner personenbezogenen Daten ein.
</pre>

=== Formbuilder CSV Export der Eingaben automatisch ===
<syntaxhighlight lang="php">
$form = $forms->load('my-formname');
$formBuilderEntries = $form->entries();
$formBuilderEntries->exportCSV($form, "any_field=any_value");

//Same as above, but shorter:

$form = $forms->load('my-formname');
$form->entries()->exportCSV($form, "any_field=any_value");
</syntaxhighlight>

=== Hooks in general ===
https://processwire.com/talk/topic/26362-general-question-on-formbuilder-and-hooks/#comment-218911

==== In Hooks auf Page zugreifen ====
Im Hook
$page = $event->wire()->page; // current $page API var
Oder per use (siehe Beispiel unten)

=== Relevante Hooks ===
Beispiele aus site/ready.php
// if (isset($forms)) //...possible too
<syntaxhighlight lang="php">

<?php namespace ProcessWire;

if(!defined("PROCESSWIRE")) die();

// E-Mails (Wert aus Template 'job' Feld: job_organizationname => Mailadresse)
if($page->template->name=='job'){

$formname = 'schnellkontakt';
$emailList = array(
'intensiv' => 'post@stephanschlegel.de',
'karlsruhe' => 'post@stephanschlegel.de',
'rastatt' => 'info@indiharart.de',
'pforzheim' => 'info@indiharart.de',
'rheinhausen' => 'info@indiharart.de',
'tagespflege' => 'info@indiharart.de',
);
$organization = $page->job->job_organizationname->title;
$organizationName = $page->job->job_organizationname->value;
$jobtitle = $page->title;

$wire->addHookBefore('FormBuilderProcessor::renderReady',
function($event) use($organization, $jobtitle, $formname) {
$form = $event->arguments(0);
if($form->name !== $formname) return;
$form->getChildByName('ich_bewerbe_mich_fur_folgende_einrichtung')
->val($organization)
->attr('disabled', 'disabled');
$form->getChildByName('ich_bewerbe_mich_als')
->val($jobtitle)
->attr('disabled', 'disabled');
}
);
// nach dem übermitteln der eingaben (user kann nichts mehr ändern)
$wire->addHook('FormBuilderProcessor::processInputDone',
function($event) use($organization, $jobtitle, $formname) {
$form = $event->arguments(0);
if($form->name !== $formname) return;
$form->getChildByName('ich_bewerbe_mich_fur_folgende_einrichtung')->val($organization);
$form->getChildByName('ich_bewerbe_mich_als')->val($jobtitle);
}
);
// change email based on job
$wire->addHookBefore('FormBuilderProcessor::emailForm',
function($event) use($organizationName, $emailList, $formname) {
$processor = $event->object;
if($processor->formName != $formname) return;
if(array_key_exists($organizationName,$emailList)){
$processor->emailTo = $emailList[$organizationName]; // tell FormBuilder to use that email
}
}
);

}

</syntaxhighlight>

=== Werte in Success Meldung anzeigen ===
https://processwire.com/talk/topic/12874-mini-how-to-display-submitted-values-in-success-message/#comment-116913
In site/ready.php I add this code...
<syntaxhighlight lang="php">
$forms->addHookAfter('FormBuilderProcessor::formSubmitSuccess', function($event) {
$form = $event->object;
if ($form->formName == 'YOUR-FORM-NAME-HERE' && $form->isSubmitted()) {
$values = $form->getValues();
array_walk($values, function(&$i){ $i = htmlentities($i, ENT_QUOTES, 'UTF-8', false); });
$form->successMessage = wirePopulateStringTags($form->successMessage, $values);
}
});
</syntaxhighlight>
... changing 'YOUR-FORM-NAME-HERE' for the actual name of your form.

I can now include submitted values in my success messages. Like this;

Thank you, {name}. A confirmation email has been sent to {email}.

If I also want to clean up submitted values, prior to the form entry being saved (and, therefore, prior to success message display) I do that in another ready.php hook. In the following example I simply make sure that my collected email field is all lowercase...

<syntaxhighlight lang="php">
$forms->addHookBefore('FormBuilderProcessor::saveForm', function($event) {
$form = $event->arguments(0);
if($form->name == 'YOUR-FORM-NAME-HERE') {
// Sanitise the email field (all lower case)...
$f = $form->get('email');
$email = strtolower($f->value);
$f->attr('value', "$email");
}
});
</syntaxhighlight>

=== E-Mail Adressen per Hook manipulieren ===
==== Admin E-Mail via User Option Feld auswählen ====
Im Formular Feld "auswahl"

<pre>
+Standortauswahl
salusklinik=Salus Klinik Bad Reichenhall
mvzreichenhall=MVZ Bad Reichenhall
mvztraunstein=MVZ Traunstein
mvzfeldmoching=MVZ Außenstelle Feldmoching
</pre>
site/ready.php
<syntaxhighlight lang="php">
// E-Mails (Wert aus Template 'job' Feld: job_organizationname => Mailadresse)
if($page->template->name=='layout-blocks'){

$formName = 'kontakt';
$optionField = 'auswahl';
$emailList = array(
// We could use e-mail adresses as a value in the select field. But to keep it more secret we use a table.
'salusklinik' => 'post@stephanschlegel.de',
'mvzreichenhall' => 'stephanschlegel@gmx.de',
'mvztraunstein' => 'info@mvztraunstein.de',
'mvzfeldmoching' => 'info@hautarzt-feldmoching.de'
);

// nach dem übermitteln der eingaben (user kann nichts mehr ändern)
$wire->addHook('FormBuilderProcessor::processInputDone',
function($event) use($formName, $optionField, $emailList) {
$processor = $event->object;
$form = $event->arguments(0);
if($form->name !== $formName) return;
$values = $processor->getValues();
if($email = $values[$optionField]){
//bd($email,'email');
if(array_key_exists($email, $emailList)) {
$processor->emailTo = $emailList[$email];
//bd($processor->emailTo,"email to");
}
}
//$form->getChildByName('message')->val($email.' email'); // use for debugging
}
);
}
</syntaxhighlight>
==== Beispiel Forum ====
Nicht getestet. Von:
https://processwire.com/talk/topic/26261-solved-send-email-to-email-address-field-in-dynamic-page/#comment-218230
In ready.php
<syntaxhighlight lang="php">
$wire->addHookBefore('FormBuilderProcessor::emailForm', function($event) {
$processor = $event->object;
if($processor->formName != 'myFormName') return;
$page = $event->wire()->page; // current $page API var
$email = $page->get('emailFieldName'); // get "email" field from current page
$processor->emailTo .= "\n" . $email; // use that email + admin Mail (Formbuilder uses one per line)
});
</syntaxhighlight>

==== Beispiel 2 - RepeaterMatrix ====
In Repeatern oder einer RepeaterMatrix ist es evtl. geschickter auf andere Weise auf das richtige Feld des Formulars zuzugreifen. Den genauen Grund warum ich hier diesen Hook verwendet habe weiß ich nicht mehr. Er funktioniert auf alle Fälle gut in der RepeaterMatrix.
<syntaxhighlight lang="php">
$emailList = array(
'auftrag' => 'stephanschlegel@gmx.de',
'marketing' => 'post@stephanschlegel.de',
'personal' => 'post@stephanschlegel.de',
'gold' => 'post@stephanschlegel.de',
'technik' => 'post@stephanschlegel.de',
'beanstandungen' => 'post@stephanschlegel.de',
'sonstiges' => 'post@stephanschlegel.de',
);

// HOOKS FÜR E-MAIL VERTEILER SCHNELLKONTAKT
if($page->template->name=='layout-blocks'){ // check if template is correct
$formname = 'schnellkontakt';
$fieldname = 'bereich'; // take value of this field as selector
$wire->addHookBefore('FormBuilderProcessor::emailForm',
function($event) use($emailList, $formname, $fieldname) {
$processor = $event->object;
if($processor->formName != $formname) return; // check if we are in correct form
$form = $event->arguments(0);
$name = $form->getChildByName($fieldname)->val();
if(array_key_exists($name,$emailList)){
$processor->emailTo = $emailList[$name]; // tell FormBuilder to use that email
}
}
);
}
</syntaxhighlight>

==== Beispiel 3 ====
Beispiel mit mehreren Formularen
<syntaxhighlight lang="php">
<?php namespace ProcessWire;

if(!defined("PROCESSWIRE")) die();

$emailList = array(
'organisationeins' => 'stephanschlegel@gmx.de',
'organisationzwei' => 'post@stephanschlegel.de',
'organisationdrei' => 'post@stephanschlegel.de',
'technik' => 'post@stephanschlegel.de',
'beanstandungen' => 'post@stephanschlegel.de',
'sonstiges' => 'post@stephanschlegel.de',
);

// HOOKS FÜR BEWERBUNG IM JOBTEMPLATE
if($page->template->name=='job'){
$formname = 'schnellkontakt';
// E-Mails (Wert aus Template 'job' Feld: job_organizationname => Mailadresse)
$organization = $page->job->job_organizationname->title;
$organizationName = $page->job->job_organizationname->value;
$jobtitle = $page->title;

$wire->addHookBefore('FormBuilderProcessor::renderReady',
function($event) use($organization, $jobtitle, $formname) {

$form = $event->arguments(0);
if($form->name !== $formname) return;
$form->getChildByName('ich_bewerbe_mich_fur_folgende_einrichtung')
->val($organization)
->attr('disabled', 'disabled');
$form->getChildByName('ich_bewerbe_mich_als')
->val($jobtitle)
->attr('disabled', 'disabled');
}
);
// nach dem übermitteln der eingaben (user kann nichts mehr ändern)
$wire->addHook('FormBuilderProcessor::processInputDone',
function($event) use($organization, $jobtitle, $formname) {
$form = $event->arguments(0);
if($form->name !== $formname) return;
$form->getChildByName('ich_bewerbe_mich_fur_folgende_einrichtung')->val($organization);
$form->getChildByName('ich_bewerbe_mich_als')->val($jobtitle);
}
);
// change email based on job
$wire->addHookBefore('FormBuilderProcessor::emailForm',
function($event) use($organizationName, $emailList, $formname) {
$processor = $event->object;
if($processor->formName != $formname) return;
if(array_key_exists($organizationName,$emailList)){
$processor->emailTo = $emailList[$organizationName]; // tell FormBuilder to use that email
}
}
);
}else{
// HOOKS FÜR INITIATIVBEWERBUNG
// change email based on job
$wire->addHookBefore('FormBuilderProcessor::emailForm',
function($event) use($emailList) {
$processor = $event->object;
if($processor->formName != 'schnellkontakt') return;
$form = $event->arguments(0);
$name = $form->getChildByName('bereich')->val();
if(array_key_exists($name,$emailList)){
$processor->emailTo = $emailList[$name]; // tell FormBuilder to use that email
}
}
);
}

</syntaxhighlight>

=== Feld Read Only bei Formular Rendering ===
https://processwire.com/talk/topic/26373-making-field-read-only/#comment-218986

=== Prepopulated Fields ===
https://processwire.com/talk/topic/25517-solved-pre-populated-fields/#comment-218903

=== PDF Download nach Form Submission ===
https://processwire.com/talk/topic/26309-solved-download-pdf-file-after-submitting-the-contact-form/#comment-218905

=== JavaScript ausführen wenn Fehler im Formular sind ===
Das ist z.B. nützlich wenn man das Formular in einem Modalfenster anzeigt und dieses nach dem Absenden nicht geöffnet ist. Dazu checkt man einfach ob in der Fehlerausgabe Daten sind:

JavaScript / jQuery
<syntaxhighlight lang="javascript">
if($("#FormBuilderSubmitted").length) {
// form was submitted and has errors -> open
showForm();
}else{
hideModal();
}
</syntaxhighlight>

=== Eigene Templates für E-Mails ===
==== Administrator E-Mail ====
Hilfe bekommst du bereits beim Erstellen im Backend:
o customize the email body, copy the template file
/site/modules/FormBuilder/email-administrator.php
into
/site/templates/FormBuilder/email-administrator.php
or
/site/templates/FormBuilder/email-administrator-testform.php
(creating the directory if not there already) and modify it to suit your needs.
==== Beispiel: Nur ausgefüllte Felder anzeigen ====
Im Template werden in der Variable $values bereits Formatiert gespeichert. Das bedeutet auch nicht übermittelte Felder enthalten Werte. Wir müssen daher die Rohwerte testen. Hier ein Beispiel wie man es machen kann:

<syntaxhighlight lang="php">
<?php namespace ProcessWire;

/**
* This is the email template used by the 'Email administrators' feature in Form Builder
*
* CUSTOMIZE
* =========
* To customize this email, copy this file to /site/templates/FormBuilder/email-administrator.php and modify it as needed.
* To make it just for a one form, name it email-administrator-myform.php, replacing "myform" with form name.
* It's preferable to do this so that your email template doesn't get overwritten during FormBuilder upgrades.
* Inline styles are recommended in the markup since not all email clients will use <style></style> declarations.
*
* VARIABLES
* =========
* @var array $values This is an array of all submitted field values with ('field name' => 'field value') where the 'field value' is ready for output.
* @var array $labels This is an array of all field labels with ('field name' => 'field label') where the 'field label' is ready for output.
* @var array $formData Raw form data array, which is the same as $values but unformatted and with additional properties like 'entryID' and '_savePage' id.
* @var FormBuilderEmail $formBuilderEmail Instance of FormBuilderEmail that is sending the message.
* @var InputfieldForm $form Containing the entire form if you want grab anything else from it.
* @var string $viewEntryUrl URL to view entry in the admin
*
*
*/

if(!defined("PROCESSWIRE")) die();
$out = '';
$fieldsMarkup = '';
$emptyFieldsMarkup = '';
$styles = array(
'table' => 'width:100%;border-bottom: 1px solid #ccc',
'label' => 'width:30%;text-align:right;font-weight:bold;padding:10px 10px 10px 0;vertical-align:top;border-top:1px solid #ccc',
'value' => 'width:70%;padding: 10px 0 10px 0;border-top: 1px solid #ccc',
);
//bd($formData, '$formData');
foreach($values as $name => $value){
//bd($value);
if( !empty( $formData[$name] ) ){
$label = (isset($labels[$name]) ? $labels[$name] : ' ');
$fieldsMarkup .= '
<tr>
<th class="label" style="' . $styles["label"] . '">' . $label . '</th>
<td class="value" style="' . $styles['value'] . '">' . $value . '</td>
</tr>
';
}else{
$emptyFieldsMarkup .= '
<p> ' . $label . '</p>';
}
}

ob_start();
?><!DOCTYPE html>
<html>
<head>
<meta http-equiv="content-type" content="text/html; charset=utf-8" />
<title><?= $form->name ?> email</title>
</head>
<body>
<table style="<?= $styles['table']?>" cellspacing="0">
<?= $fieldsMarkup ?>
</table>
<div>
<p>Leere Felder oder kein Wert gewählt:</p>
<?= $emptyFieldsMarkup ?>
</div>
<p><small><?= date('d.m.Y g:i') ?></small></p>
</body>
</html>
<?php
$out = ob_get_clean();
echo $out;
?>
</syntaxhighlight>

== FormBuilder File Upload ==
=== Links ===

== Feldtypen hinzufügen ==
In den Settings von Formbuilder kann man Felder auswählen die man im Formular verwenden möchte. Z.B. erlaubt das Markup Feld das Einfügen von Text etc.
=== Text im Formular einfügen ===
Z.B. mit Markup Feld.

Vorsicht CK-Editor funktioniert nicht. Mit diesem stellst du dem User ein Eingabefeld mit Editor zur Verfügung (ungetestet - evtl. funktioniert das auch nicht oder erzeugt eine Sicherheitslücke).

ProcessWire - FormBuilder (Module)

2025-04-30T08:53:12Z

109.193.152.88: /* Tipps und Tricks für Formbuilder */

https://processwire.com/store/form-builder/

== Mails per smtp versenden ==
[[ProcessWire - WireMailSmtp (Module)]]

== CSS bei einfachem embed per iFrame anpassen ==
Einfache Lösung:
* auf Basic Output stellen
* Standard CSS von /site/templates/FormBuilder/main.css kopieren
* Neuen Pfad im Formbuilder Formular eingeben.
Nachteil, das könnte für den User zu kompliziert sein.

== Import Daten für Standard Formular ==
Hiermit kann man schnell ein Formular erstellen. Einfach in Import Feld des Formbuilder kopieren.
Einfaches Standardformular:
<pre>
{
"action": "./",
"method": "post",
"roles": {
"form-submit": [
"guest"
],
"form-list": [],
"form-edit": [],
"form-delete": [],
"entries-list": [],
"entries-edit": [],
"entries-delete": [],
"entries-page": []
},
"framework": "Basic",
"submitText": "Senden",
"successMessage": "Vielen Dank, ihre Nachricht wurde versendet.",
"errorMessage": "Entschuldigung, das Formular konnte nicht versendet werden. Bitte füllen Sie alle Pflichtfelder aus. Zur Kontaktaufnahme benötigen wir entweder Ihre E-Mail oder Ihre Telefonnummer.",
"emailSubject": "Nachricht über Ihr Kontaktformular",
"responderSubject": "Auto-Response",
"saveFlags": 2,
"emailTo": "post@stephanschlegel.de",
"emailFrom": "e_mail",
"submitText1018": "Senden",
"successMessage1018": "Vielen Dank, ihre Nachricht wurde versendet.",
"errorMessage1018": "Entschuldigung, das Formular konnte nicht versendet werden. Bitte füllen Sie alle Pflichtfelder aus.",
"frBasic_cssURL": "/site/templates/styles/forms.css",
"frFoundation_foundationURL": "/site/modules/FormBuilder/frameworks/foundation/",
"frFoundation_horizHeaderClass": "small-5 medium-3 right inline",
"frFoundation_horizContentClass": "small-7 medium-9",
"frUikit_ukURL": "/site/modules/FormBuilder/frameworks/uikit/",
"frUikit_css": "uikit.gradient.min.css",
"frUikit_horizHeaderWidth": 30,
"frAdmin_styleSet": "AdminThemeDefault/styles/main-classic.css",
"frBootstrap_bootURL": "/site/modules/FormBuilder/frameworks/bootstrap/",
"frBootstrap_bootHorizHeaderClass": "col-xs-5 col-sm-4 col-md-3",
"frBootstrap_bootHorizContentClass": "col-xs-7 col-sm-8 col-md-9",
"children": {
"name_1": {
"type": "Text",
"label": "Name",
"label1018": "Ihr Name",
"maxlength": 2048,
"requiredAttr": 1
},
"telefon": {
"type": "Text",
"label": "Telefon",
"required": 1,
"columnWidth": 50,
"label1018": "Ihre Telefonnummer",
"maxlength": 2048,
"requiredAttr": 1,
"requiredIf": "e_mail=''",
"stripTags": 1
},
"e_mail": {
"type": "Text",
"label": "E-Mail",
"required": 1,
"columnWidth": 50,
"label1018": "Ihre E-Mail",
"maxlength": 2048,
"requiredIf": "telefon=''",
"stripTags": 1
},
"ihre_nachricht": {
"type": "Textarea",
"label": "Ihre Nachricht",
"required": 1,
"label1018": "Ihre Nachricht",
"rows": 5
},
"datenschutz": {
"type": "Checkbox",
"label": "Datenschutz",
"description": "Mit meiner Kontaktaufnahme willige ich ein, dass meine Daten gespeichert und zur Bearbeitung meiner Anfrage/Kontaktaufnahme genutzt werden. Meine Daten werden niemals an Dritte weitergeleitet. Diese Einwilligung kann jederzeit widerrufen werden.",
"required": 1,
"label1018": "Datenschutz",
"description1018": "Mit meiner Kontaktaufnahme willige ich ein, dass meine Daten gespeichert und zur Bearbeitung meiner Anfrage/Kontaktaufnahme genutzt werden. Meine Daten werden niemals an Dritte weitergeleitet. Diese Einwilligung kann jederzeit widerrufen werden.",
"checkedValue": "Ich stimme zu"
}
}
}
</pre>
Mit Adresse...
<pre>
{
"roles": {
"form-submit": [
"guest"
],
"form-list": [],
"form-edit": [],
"form-delete": [],
"entries-list": [],
"entries-edit": [],
"entries-delete": [],
"entries-page": []
},
"framework": "Basic",
"submitText": "Senden",
"successMessage": "Vielen Dank, ihre Nachricht wurde versendet.",
"errorMessage": "Entschuldigung, das Formular konnte nicht versendet werden. Bitte füllen Sie alle Pflichtfelder aus. Zur Kontaktaufnahme benötigen wir entweder Ihre E-Mail oder Ihre Telefonnummer.",
"emailSubject": "Nachricht über Ihr Kontaktformular",
"responderSubject": "Auto-Response",
"saveFlags": 2,
"emailTo": "post@stephanschlegel.de",
"emailFrom": "e_mail",
"submitText1018": "Senden",
"successMessage1018": "Vielen Dank, ihre Nachricht wurde versendet.",
"errorMessage1018": "Entschuldigung, das Formular konnte nicht versendet werden. Bitte füllen Sie alle Pflichtfelder aus.",
"frBasic_cssURL": "/site/templates/styles/forms.css",
"frFoundation_foundationURL": "/site/modules/FormBuilder/frameworks/foundation/",
"frFoundation_horizHeaderClass": "small-5 medium-3 right inline",
"frFoundation_horizContentClass": "small-7 medium-9",
"frUikit_ukURL": "/site/modules/FormBuilder/frameworks/uikit/",
"frUikit_css": "uikit.gradient.min.css",
"frUikit_horizHeaderWidth": 30,
"frAdmin_styleSet": "AdminThemeDefault/styles/main-classic.css",
"frBootstrap_bootURL": "/site/modules/FormBuilder/frameworks/bootstrap/",
"frBootstrap_bootHorizHeaderClass": "col-xs-5 col-sm-4 col-md-3",
"frBootstrap_bootHorizContentClass": "col-xs-7 col-sm-8 col-md-9",
"children": {
"name_1": {
"type": "Text",
"label": "Name",
"label1018": "Ihr Name",
"maxlength": 2048,
"requiredAttr": 1
},
"telefon": {
"type": "Text",
"label": "Telefon",
"required": 1,
"columnWidth": 50,
"label1018": "Ihre Telefonnummer",
"maxlength": 2048,
"requiredAttr": 1,
"requiredIf": "e_mail=''",
"stripTags": 1
},
"e_mail": {
"type": "Text",
"label": "E-Mail",
"required": 1,
"columnWidth": 50,
"label1018": "Ihre E-Mail",
"maxlength": 2048,
"requiredIf": "telefon=''",
"stripTags": 1
},
"ihre_adresse": {
"type": "Text",
"label": "Straße",
"columnWidth": 80,
"label1018": "Straße",
"requiredAttr": 1,
"maxlength": 2048,
"size": 100
},
"hausnummer": {
"type": "Text",
"label": "Hausnr.",
"required": 1,
"columnWidth": 20,
"label1018": "Hausnr.",
"maxlength": 2048
},
"plz_ort": {
"type": "Text",
"label": "PLZ Ort",
"label1018": "PLZ Ort",
"maxlength": 2048
},
"ihre_nachricht": {
"type": "Textarea",
"label": "Ihre Nachricht",
"required": 1,
"label1018": "Ihre Nachricht",
"rows": 5,
"requiredAttr": 1
},
"datenschutz": {
"type": "Checkbox",
"label": "Datenschutz",
"description": "Mit meiner Kontaktaufnahme willige ich ein, dass meine Daten gespeichert und zur Bearbeitung meiner Anfrage/Kontaktaufnahme genutzt werden. Meine Daten werden niemals an Dritte weitergeleitet. Diese Einwilligung kann jederzeit widerrufen werden.",
"required": 1,
"label1018": "Datenschutz",
"description1018": "Mit meiner Kontaktaufnahme willige ich ein, dass meine Daten gespeichert und zur Bearbeitung meiner Anfrage/Kontaktaufnahme genutzt werden. Meine Daten werden niemals an Dritte weitergeleitet. Diese Einwilligung kann jederzeit widerrufen werden.",
"checkedValue": "1"
}
}
}
</pre>

==Tipps und Tricks für Formbuilder==
=== Weiterleitung / Redirect auf Danke Seite ===

=== DatePicker ===
==== Lokalisierung / Sprache einstellen====
Der Formbuilder nutzt das Standard InputField Datetime. Das kann man übersetzen:
https://processwire.com/talk/topic/4547-possibility-to-translate-timepicker-addon-on-datepicker/?tab=comments#comment-49746

In der folgenden datei kann man als Übersetzung den Pfad zur Lokalisierungsdatei von jQuery angeben (ist im PW mit drin).

Die Datei muss man evtl. selber anlegen (im Übersetzungstool) wenn die Indizierung sie nicht schon selbst angelegt hat.

/wire/modules/Inputfield/InputfieldDatetime/types/InputfieldDatetimeText.php
path: /wire/modules/Jquery/JqueryUI/i18n/jquery.ui.datepicker-de.js

=== Links in Checkbox-Label ===
HTML geht nicht aber Markdown funktioniert:
<pre>
Ich habe die [Datenschutzerklärung](https://fbz-vet.de/datenschutz) gelesen und willige in die dort dargestellte Verarbeitung meiner personenbezogenen Daten ein.
</pre>

=== Formbuilder CSV Export der Eingaben automatisch ===
<syntaxhighlight lang="php">
$form = $forms->load('my-formname');
$formBuilderEntries = $form->entries();
$formBuilderEntries->exportCSV($form, "any_field=any_value");

//Same as above, but shorter:

$form = $forms->load('my-formname');
$form->entries()->exportCSV($form, "any_field=any_value");
</syntaxhighlight>

=== Hooks in general ===
https://processwire.com/talk/topic/26362-general-question-on-formbuilder-and-hooks/#comment-218911

==== In Hooks auf Page zugreifen ====
Im Hook
$page = $event->wire()->page; // current $page API var
Oder per use (siehe Beispiel unten)

=== Relevante Hooks ===
Beispiele aus site/ready.php
// if (isset($forms)) //...possible too
<syntaxhighlight lang="php">

<?php namespace ProcessWire;

if(!defined("PROCESSWIRE")) die();

// E-Mails (Wert aus Template 'job' Feld: job_organizationname => Mailadresse)
if($page->template->name=='job'){

$formname = 'schnellkontakt';
$emailList = array(
'intensiv' => 'post@stephanschlegel.de',
'karlsruhe' => 'post@stephanschlegel.de',
'rastatt' => 'info@indiharart.de',
'pforzheim' => 'info@indiharart.de',
'rheinhausen' => 'info@indiharart.de',
'tagespflege' => 'info@indiharart.de',
);
$organization = $page->job->job_organizationname->title;
$organizationName = $page->job->job_organizationname->value;
$jobtitle = $page->title;

$wire->addHookBefore('FormBuilderProcessor::renderReady',
function($event) use($organization, $jobtitle, $formname) {
$form = $event->arguments(0);
if($form->name !== $formname) return;
$form->getChildByName('ich_bewerbe_mich_fur_folgende_einrichtung')
->val($organization)
->attr('disabled', 'disabled');
$form->getChildByName('ich_bewerbe_mich_als')
->val($jobtitle)
->attr('disabled', 'disabled');
}
);
// nach dem übermitteln der eingaben (user kann nichts mehr ändern)
$wire->addHook('FormBuilderProcessor::processInputDone',
function($event) use($organization, $jobtitle, $formname) {
$form = $event->arguments(0);
if($form->name !== $formname) return;
$form->getChildByName('ich_bewerbe_mich_fur_folgende_einrichtung')->val($organization);
$form->getChildByName('ich_bewerbe_mich_als')->val($jobtitle);
}
);
// change email based on job
$wire->addHookBefore('FormBuilderProcessor::emailForm',
function($event) use($organizationName, $emailList, $formname) {
$processor = $event->object;
if($processor->formName != $formname) return;
if(array_key_exists($organizationName,$emailList)){
$processor->emailTo = $emailList[$organizationName]; // tell FormBuilder to use that email
}
}
);

}

</syntaxhighlight>

=== Werte in Success Meldung anzeigen ===
https://processwire.com/talk/topic/12874-mini-how-to-display-submitted-values-in-success-message/#comment-116913
In site/ready.php I add this code...
<syntaxhighlight lang="php">
$forms->addHookAfter('FormBuilderProcessor::formSubmitSuccess', function($event) {
$form = $event->object;
if ($form->formName == 'YOUR-FORM-NAME-HERE' && $form->isSubmitted()) {
$values = $form->getValues();
array_walk($values, function(&$i){ $i = htmlentities($i, ENT_QUOTES, 'UTF-8', false); });
$form->successMessage = wirePopulateStringTags($form->successMessage, $values);
}
});
</syntaxhighlight>
... changing 'YOUR-FORM-NAME-HERE' for the actual name of your form.

I can now include submitted values in my success messages. Like this;

Thank you, {name}. A confirmation email has been sent to {email}.

If I also want to clean up submitted values, prior to the form entry being saved (and, therefore, prior to success message display) I do that in another ready.php hook. In the following example I simply make sure that my collected email field is all lowercase...

<syntaxhighlight lang="php">
$forms->addHookBefore('FormBuilderProcessor::saveForm', function($event) {
$form = $event->arguments(0);
if($form->name == 'YOUR-FORM-NAME-HERE') {
// Sanitise the email field (all lower case)...
$f = $form->get('email');
$email = strtolower($f->value);
$f->attr('value', "$email");
}
});
</syntaxhighlight>

=== E-Mail Adressen per Hook manipulieren ===
==== Admin E-Mail via User Option Feld auswählen ====
Im Formular Feld "auswahl"

<pre>
+Standortauswahl
salusklinik=Salus Klinik Bad Reichenhall
mvzreichenhall=MVZ Bad Reichenhall
mvztraunstein=MVZ Traunstein
mvzfeldmoching=MVZ Außenstelle Feldmoching
</pre>
site/ready.php
<syntaxhighlight lang="php">
// E-Mails (Wert aus Template 'job' Feld: job_organizationname => Mailadresse)
if($page->template->name=='layout-blocks'){

$formName = 'kontakt';
$optionField = 'auswahl';
$emailList = array(
// We could use e-mail adresses as a value in the select field. But to keep it more secret we use a table.
'salusklinik' => 'post@stephanschlegel.de',
'mvzreichenhall' => 'stephanschlegel@gmx.de',
'mvztraunstein' => 'info@mvztraunstein.de',
'mvzfeldmoching' => 'info@hautarzt-feldmoching.de'
);

// nach dem übermitteln der eingaben (user kann nichts mehr ändern)
$wire->addHook('FormBuilderProcessor::processInputDone',
function($event) use($formName, $optionField, $emailList) {
$processor = $event->object;
$form = $event->arguments(0);
if($form->name !== $formName) return;
$values = $processor->getValues();
if($email = $values[$optionField]){
//bd($email,'email');
if(array_key_exists($email, $emailList)) {
$processor->emailTo = $emailList[$email];
//bd($processor->emailTo,"email to");
}
}
//$form->getChildByName('message')->val($email.' email'); // use for debugging
}
);
}
</syntaxhighlight>
==== Beispiel Forum ====
Nicht getestet. Von:
https://processwire.com/talk/topic/26261-solved-send-email-to-email-address-field-in-dynamic-page/#comment-218230
In ready.php
<syntaxhighlight lang="php">
$wire->addHookBefore('FormBuilderProcessor::emailForm', function($event) {
$processor = $event->object;
if($processor->formName != 'myFormName') return;
$page = $event->wire()->page; // current $page API var
$email = $page->get('emailFieldName'); // get "email" field from current page
$processor->emailTo .= "\n" . $email; // use that email + admin Mail (Formbuilder uses one per line)
});
</syntaxhighlight>

==== Beispiel 2 - RepeaterMatrix ====
In Repeatern oder einer RepeaterMatrix ist es evtl. geschickter auf andere Weise auf das richtige Feld des Formulars zuzugreifen. Den genauen Grund warum ich hier diesen Hook verwendet habe weiß ich nicht mehr. Er funktioniert auf alle Fälle gut in der RepeaterMatrix.
<syntaxhighlight lang="php">
$emailList = array(
'auftrag' => 'stephanschlegel@gmx.de',
'marketing' => 'post@stephanschlegel.de',
'personal' => 'post@stephanschlegel.de',
'gold' => 'post@stephanschlegel.de',
'technik' => 'post@stephanschlegel.de',
'beanstandungen' => 'post@stephanschlegel.de',
'sonstiges' => 'post@stephanschlegel.de',
);

// HOOKS FÜR E-MAIL VERTEILER SCHNELLKONTAKT
if($page->template->name=='layout-blocks'){ // check if template is correct
$formname = 'schnellkontakt';
$fieldname = 'bereich'; // take value of this field as selector
$wire->addHookBefore('FormBuilderProcessor::emailForm',
function($event) use($emailList, $formname, $fieldname) {
$processor = $event->object;
if($processor->formName != $formname) return; // check if we are in correct form
$form = $event->arguments(0);
$name = $form->getChildByName($fieldname)->val();
if(array_key_exists($name,$emailList)){
$processor->emailTo = $emailList[$name]; // tell FormBuilder to use that email
}
}
);
}
</syntaxhighlight>

==== Beispiel 3 ====
Beispiel mit mehreren Formularen
<syntaxhighlight lang="php">
<?php namespace ProcessWire;

if(!defined("PROCESSWIRE")) die();

$emailList = array(
'organisationeins' => 'stephanschlegel@gmx.de',
'organisationzwei' => 'post@stephanschlegel.de',
'organisationdrei' => 'post@stephanschlegel.de',
'technik' => 'post@stephanschlegel.de',
'beanstandungen' => 'post@stephanschlegel.de',
'sonstiges' => 'post@stephanschlegel.de',
);

// HOOKS FÜR BEWERBUNG IM JOBTEMPLATE
if($page->template->name=='job'){
$formname = 'schnellkontakt';
// E-Mails (Wert aus Template 'job' Feld: job_organizationname => Mailadresse)
$organization = $page->job->job_organizationname->title;
$organizationName = $page->job->job_organizationname->value;
$jobtitle = $page->title;

$wire->addHookBefore('FormBuilderProcessor::renderReady',
function($event) use($organization, $jobtitle, $formname) {

$form = $event->arguments(0);
if($form->name !== $formname) return;
$form->getChildByName('ich_bewerbe_mich_fur_folgende_einrichtung')
->val($organization)
->attr('disabled', 'disabled');
$form->getChildByName('ich_bewerbe_mich_als')
->val($jobtitle)
->attr('disabled', 'disabled');
}
);
// nach dem übermitteln der eingaben (user kann nichts mehr ändern)
$wire->addHook('FormBuilderProcessor::processInputDone',
function($event) use($organization, $jobtitle, $formname) {
$form = $event->arguments(0);
if($form->name !== $formname) return;
$form->getChildByName('ich_bewerbe_mich_fur_folgende_einrichtung')->val($organization);
$form->getChildByName('ich_bewerbe_mich_als')->val($jobtitle);
}
);
// change email based on job
$wire->addHookBefore('FormBuilderProcessor::emailForm',
function($event) use($organizationName, $emailList, $formname) {
$processor = $event->object;
if($processor->formName != $formname) return;
if(array_key_exists($organizationName,$emailList)){
$processor->emailTo = $emailList[$organizationName]; // tell FormBuilder to use that email
}
}
);
}else{
// HOOKS FÜR INITIATIVBEWERBUNG
// change email based on job
$wire->addHookBefore('FormBuilderProcessor::emailForm',
function($event) use($emailList) {
$processor = $event->object;
if($processor->formName != 'schnellkontakt') return;
$form = $event->arguments(0);
$name = $form->getChildByName('bereich')->val();
if(array_key_exists($name,$emailList)){
$processor->emailTo = $emailList[$name]; // tell FormBuilder to use that email
}
}
);
}

</syntaxhighlight>

=== Feld Read Only bei Formular Rendering ===
https://processwire.com/talk/topic/26373-making-field-read-only/#comment-218986

=== Prepopulated Fields ===
https://processwire.com/talk/topic/25517-solved-pre-populated-fields/#comment-218903

=== PDF Download nach Form Submission ===
https://processwire.com/talk/topic/26309-solved-download-pdf-file-after-submitting-the-contact-form/#comment-218905

=== JavaScript ausführen wenn Fehler im Formular sind ===
Das ist z.B. nützlich wenn man das Formular in einem Modalfenster anzeigt und dieses nach dem Absenden nicht geöffnet ist. Dazu checkt man einfach ob in der Fehlerausgabe Daten sind:

JavaScript / jQuery
<syntaxhighlight lang="javascript">
if($("#FormBuilderSubmitted").length) {
// form was submitted and has errors -> open
showForm();
}else{
hideModal();
}
</syntaxhighlight>

=== Eigene Templates für E-Mails ===
==== Administrator E-Mail ====
Hilfe bekommst du bereits beim Erstellen im Backend:
o customize the email body, copy the template file
/site/modules/FormBuilder/email-administrator.php
into
/site/templates/FormBuilder/email-administrator.php
or
/site/templates/FormBuilder/email-administrator-testform.php
(creating the directory if not there already) and modify it to suit your needs.

== FormBuilder File Upload ==
=== Links ===

== Feldtypen hinzufügen ==
In den Settings von Formbuilder kann man Felder auswählen die man im Formular verwenden möchte. Z.B. erlaubt das Markup Feld das Einfügen von Text etc.
=== Text im Formular einfügen ===
Z.B. mit Markup Feld.

Vorsicht CK-Editor funktioniert nicht. Mit diesem stellst du dem User ein Eingabefeld mit Editor zur Verfügung (ungetestet - evtl. funktioniert das auch nicht oder erzeugt eine Sicherheitslücke).

ProcessWire - Snippets

2025-04-30T08:12:08Z

109.193.152.88: /* Umfassende Renderfunktion zum wiederverwenden */

Hier findest du ein paar Basis Snippets. Codebeispiele zu Feldern findest du z.B. über die Seiten zu den Field Types.

== Siehe auch ==
[[ProcessWire - Module Snippets]]
[[ProcessWire - Navigation Snippets]]
[[ProcessWire - Debugging Snippets]]
[[ProcessWire - Selectors]]

== Basics ==
=== Bild in Template einbinden ===
<img src="<?php echo $config->urls->templates?>img/menu.png" alt="Home">

=== Link zu Seite ===
<a href="<?php echo $pages->get('/kontakt/')->url; ?>">
=== Wert aus Textfeld ===
<div class="<? echo $page->get("content_class")?>">
== Bilder ==

=== Umfassende Renderfunktion zum wiederverwenden ===
Hier immer wieder aktualisiert. Todo Option für srcset.
<syntaxhighlight lang="php">

/**
* render image tag from imageobject
* @todo add srcset version,add ukimage version, other attributes
* @todo attributes as object or string
* @param Object Image
* @param Int width
* @return String
*/
function renderImage($image,$w=200,$options=array()){
if(!$image instanceof \ProcessWire\Pageimage) return '';
$defaults = array(
'resizeHeight' => false, // use height instead of width to resize
'srcset' => false, // todo
'uikit' => false, // todo
'aspect' => false,
'noResize' => false,
'classes' => '', // classes as string
'attributes' => false, // attributes as array(attr=>val) or string
'title' => true, // add title tag based on image description
'alt' => true, // add alt tag based on image description
);
$options = array_merge($defaults,$options);
$attributes = array();
$strAttr = '';
$classMarkup = '';

// ATTRIBUTES
$attributesMarkup = '';
if( $options['attributes'] ){
bd( gettype( $options['attributes'] ) );
if( gettype($options['attributes'] ) == 'string') $strAttr = (string)$options['attributes'];
else if( gettype($options['attributes']) == 'array' ){
foreach( (array)$options['attributes'] as $k => $a ){
$attributes[$k] = $a;
}
}
}
if($options['alt'] && $image->description) $attributes['alt'] = $image->description;
if($options['title'] && $image->description) $attributes['title'] = $image->description;
$attributesMarkup = implode(' ', $attributes);
if($strAttr) $attributesMarkup .= " $strAttr";

if($options['classes']) $classMarkup = ' class="'.$options['classes'].'"';

if($options['resizeHeight']){
$i = $image->height($w);
}else if($options['aspect']){
$i = $image->size($w, intval( $w / $options['aspect']) );
}else if($options['noResize']){
// Todo

}else{
$i = $image->width($w);
}
$out = '<img src="'.$i->url.'" '.$classMarkup.$attributesMarkup.'>';
return $out;
}
</syntaxhighlight>

=== Advanced Image Manipulation ===
ImageMagick, Externe Bilder laden, Bilder Vorrendern...
[[Processwire - Advanced Image Manipulation]]

=== Praktische Renderfunktionen ===
<syntaxhighlight lang="php">
/**
* Image Function
*/

/**
* get background-position style via focus point if available
* mainly used in other functions
* @param Pageimage PW image object
* @return Array containing background-position
*/
function getFocusStyles($image){
// Focal Points if available
$imageStyles = array();
if($image->focus){
$focus=$image->focus();
//var_dump($focus);
$imageStyles[] = 'background-position:'.number_format($focus["left"],1,".","") .'% '.number_format($focus["top"],1,".","").'%;';
}
return $imageStyles;
}

/**
* get background-image styles and create image
* @todo - make image set instead of single image
* @param Pageimage
* @param Int Image width
* @param String background-size attribute (cover, contain...)
* @return array
*/
function getBgImageStyles($image, $w = 800,$options = array()){
$defaults = array(
'size' => 'cover',
'noResize' => false
);
$options = array_merge($defaults,$options);

if($image){
$styles = array();
if ($options['noResize']) $myImage = $image;
else $myImage = $image->width($w);
$styles[] = "background-image: url($myImage->url);";
$styles[] = 'background-size: '.$options['size'].'; background-repeat: no-repeat;';
$styles = array_merge( $styles, getFocusStyles($myImage) );
return $styles;
} else return array();

}

/**
* render image tag from imageobject
* @todo add srcset version, add description, add ukimage version, other attributes
* @param Object Image
* @param Int width
* @return String
*/
function renderImage($image,$w=200,$options=array()){
if(!$image instanceof \ProcessWire\Pageimage) return '';
$defaults = array(
'resizeHeight' => false, // use height instead of width to resize
'srcset' => false, // todo
'uikit' => false, // todo
'aspect' => false,
'noResize' => false
);
$options = array_merge($defaults,$options);
if($options['resizeHeight']){
$i = $image->height($w);
}else if($options['aspect']){
$i = $image->size($w, intval( $w / $options['aspect']) );
}else if($options['noResize']){
// Todo

}else{
$i = $image->width($w);
}
$out = '<img src="'.$i->url.'" alt="'.$i->description.'">';
return $out;
}
</php>
</syntaxhighlight>

=== Einzelbild einfügen ===

==== Maximale Breite oder maximale Höhe je nach Orientierung ====
$thumburl = $image->width > $image->height ? $image->size(450,0)->url : $image->size(0,320);

==== Maximale Breite und maximale Höhe berücksichtigen ====
<syntaxhighlight lang="php">
$mW = 180;
$mH = 80;
$thumbUrl = ($mH / $image->height) > ($mW / $image->width) ? $image->size($mW,0)->url : $image->size(0,$mH)->url;
</syntaxhighlight>

====Bild aus Backend als Hintergrund einfügen====
(Feldname hier: ''main_image'')
<syntaxhighlight lang="php">
if($page->main_image){$image = $page->main_image->size(640,960);}
else $image = NULL;
...
if($image){
echo "
<div class='a-3-4 team-image' style='background-image:url({$image->url})'>
<div>{$myContent}</div>
</div>
";
}
</syntaxhighlight>

=== n-tes Bild einfügen ===
$page->images->eq(1); // second image

=== Mehrere Bilder aus dem Backend ===
<syntaxhighlight lang="php">
$myImages='';
if(count($page->images)) {
foreach($page->images as $image) {
$myImages .= '<img class="img-responsive" src="'.$image->url.'">';
}
}
</syntaxhighlight>
'''Beispiel 2'''
<syntaxhighlight lang="php">
echo $page->images->implode(function($item) {
$large = $item->size(1200,800);
$thumb = $item->size(400,300);
return "<li><a href='$large->url'><img src='$thumb->url' alt='$item->description'></a></li>";
}, array('prepend' => '<ul>', 'append' => '</ul>'));
</syntaxhighlight>

==== Einfache Galerie ====
<syntaxhighlight lang="php">
$gallery = '<div class="gallery">';
$images = $page->gallery;

// add thumbnail to gallery
if(count($page->thumbnail)){
$gallery .= '<a class="chocolat-image gallery-item" href="'.$page->thumbnail->url.'"><img src="'. $page->thumbnail->getThumb('thumbnail') .'" title="'. $image->description .'"></a>';
}

foreach($images as $image){
$gallery .= '<a class="chocolat-image gallery-item" href="'.$image->url.'"><img src="'. $image->getThumb('thumbnail') .'" title="'. $image->description .'"></a> ';
}
$gallery .= '</div>';
</syntaxhighlight>

=== Slider mit Processwire ===
[[Processwire - Slider]]

== Videos ==
[[Processwire - Working with Video]]

== File Uploads ==
[[ProcessWire - Uploads]]

== Navigation ==
[[ProcessWire - Navigation Snippets]]

== Seiten ==
http://processwire.com/api/variables/pages/
=== Inhalt einer Seite mit $page->get() ===
Beispiel
<syntaxhighlight lang="php">
<p>Visit us at:  <?php 
$contact = $pages->get("/about/contact/");
echo $contact->address;
?> </p>
</syntaxhighlight>
Kürzer:
<syntaxhighlight lang="php">
<p>Visit us at: <?=$pages->get("/about/contact/")->address?></p>
</syntaxhighlight>

=== Seiten Filtern find() ===
==== "Featured" Checkbox im Backend angehakt ====
<syntaxhighlight lang="php">
<ul> <?php 
$features = $pages->find("featured=1");
foreach($features as $feature)
echo "<li><a href='{$feature->url}'>{$feature->title}</a></li>";
?> </ul>
</syntaxhighlight>

==== Beispiel: Limitierte Ausgabe, Sortieren und in Unterverzeichnis ====
$pages->find("parent=/about/press/, featured=1, limit=3, sort=-date");
oder
$pages->get("/about/press/")->children("featured=1, limit=3, sort=-date");
Finde in Kategorie
$pages->get("/about/press/")->find("featured=1, limit=3, sort=-date");

==== Seiten mit Template xyz ====
$pages->find("template=press_release, featured=1, limit=3, sort=-date");
Ausführliches Beispiel mit Ausgabe
<syntaxhighlight lang="php">
<ul> <?php 
$features = $pages->find("template=press_release, featured=1, limit=3, sort=-date");
foreach($features as $feature) {
echo "<li>" .
"<h3><a href='{$feature->url}'>{$feature->title}</a></h3>" .
"<span class='date'>{$feature->date}</span>" .
"<p>{$feature->summary}</p>" .
"</li>"; 
}
?></ul>
</syntaxhighlight>

== Felder ==
=== Label zu Feldes und Subfeldern ausgeben ===
Beispiel mit dem Combo Profield. Das Prinzip funktioniert bei allen Feldern.
https://processwire.com/talk/topic/26183-getting-label-of-combo-subfield/#comment-217749
<syntaxhighlight lang="php">
$field = $fields->get('your_combo_field_name');
$settings = $field->getComboSettings();
$subfield = $settings->getSubfield('your_subfield_name');

// get label in current user language
$label = $subfield->getLabel();

// to get in a language other than current user language
$label = $subfield->getLabel('de');

// to get localized description
$description = $subfield->getDescription();

// to get localized notes
$notes = $subfield->getNotes();

// also note you can use getLanguageValue
$label = $subfield->getLanguageValue('de', 'label');
</syntaxhighlight>

=== Label eines Felds ausgeben ===
Geht über das Feld-Objekt.
echo $fields->get("body")->label;

=== Ist ein Feld leer ? ===
if($page->summary_de) { ... }
// check whitespace
if(trim($page->summary_de)) { ... }

=== Datumsfelder formatieren ===
<syntaxhighlight lang="php">

// aus Datumsfeldern
echo date("Y-m-d", $page->getUnformatted("closing"));

// aus Unix Timestamp mit Vanilla PHP
echo date("Y-m-d", $news->created);

setlocale(LC_TIME, "de_DE.utf8");
$weekday = strftime ( '%A' , $page->getUnformatted("date") );
$date = date("d.m.Y", $page->getUnformatted("date"));
</syntaxhighlight>

Beispiel aus ProcessWire Blog
<syntaxhighlight lang="php">
setlocale(LC_ALL, array('de_DE','de_DE.iso88591','de_DE.iso885915@euro','de_DE.utf8','de_DE@euro'));
$date = $page->date ? date('d.m.Y',$page->getUnformatted("date")) : date('d.m.Y',$page->getUnformatted("createdStr"));
</syntaxhighlight>

=== Optionen eines Select Felds ausgeben (fieldtypeOptions)===
<syntaxhighlight lang="php">
$options = $fieldtypes->get('FieldtypeOptions')->getOptions('YOURFIELDNAME');
foreach($options as $option) {
echo $option->id;
echo $option->value;
echo $option->title;
}
</syntaxhighlight>

=== Parent von Repeater oder RepeaterMatrix finden ===
Nutzt man ein Repeater Feld muss man manchmal die Seite herausfinden in der das Feld enthalten ist. Hierfür gibt es die Funktion getForPage().
<syntaxhighlight lang="php">
if( get_class($myPage) == 'ProcessWire\RepeaterMatrixPage' || get_class($myPage) == 'ProcessWire\RepeaterPage') {
$forPage = $myPage->getForPage();
//var_dump( $myPage->getForPage());
return $myPage = getImagePage($forPage);
}
</syntaxhighlight>

Falls man Repeater in Repeatern hat kann man auch eine rekursive Funktion nutzen:

<syntaxhighlight lang="php">
if (!function_exists('getForPage')) {

function getForPage($myPage, $level=1){
// if in repeater or repeaterMatrix find the first parent ProcessWire\Page Page
$maxLevel=5;
if( get_class($myPage) == 'ProcessWire\RepeaterMatrixPage' || get_class($myPage) == 'ProcessWire\RepeaterPage') {
$level +=1;
if($level > $maxLevel) return false;
$forPage = $myPage->getForPage();
//var_dump( $myPage->getForPage());
//echo("<p>next Level: ".get_class($forPage)."</p>");
return $myPage = getForPage($forPage);

}else if( get_class($myPage) == 'ProcessWire\Page'){

return $myPage;
}
}
}
</syntaxhighlight>

== Searchbar ==
<pre>

<form class='search' action='<?php echo $pages->get('template=search')->url; ?>' method='get'>
<input type='text' name='q' placeholder='Search' value='<?php echo $sanitizer->entities($input->whitelist('q')); ?>' />
<button type='submit' name='submit'>Search</button>
</form>

</pre>
== Create Admin User ==
=== Reset Password - Passwort zurücksetzen ===
<syntaxhighlight lang="php">
<?php
require "index.php";
$admin = $users->get('admin1'); // or whatever your username is
$admin->setAndSave('pass', 'geheim');
?>
</syntaxhighlight>

https://processwire-recipes.com/recipes/resetting-admin-password-via-api/
Problem
For some reason, you have managed to lock yourself out of a site you are currently developing.

Solution
Paste the following into a file (e.g. "reset.php") in the root folder of the site, then run it.

ProcessWire version >= 2.6.9

<pre>
require "index.php";
$admin = $users->get('admin'); // or whatever your username is
$admin->setAndSave('pass', 'yo123456');
</pre>

ProcessWire version < 2.6.9

<pre>
require "index.php";
$admin = wire('users')->get('admin');
$admin->setOutputFormatting(false);
$admin->set('pass', 'yo12345');
$admin->save('pass');
</pre>

== Editor Link / Login Logout Link ==
_main.php
<syntaxhighlight lang="php">
<div class="editor">
<?php
if($user->isLoggedin()) {
// if user is logged in, show a logout link
echo "<a href='{$config->urls->admin}login/logout/'>Logout ($user->name)</a>";
} else {
// if user not logged in, show a login link
echo "<a href='{$config->urls->admin}'>∆</a>";
}
// output an "Edit" link if this page happens to be editable by the current user
if($page->editable()) echo "<li class='edit nav'><a href='$page->editUrl'>Edit</a></li>";
?>
</div>
</syntaxhighlight>
Siehe auch [[ProcessWire - User Login / Logout]]

== Conditions ==
=== Bedingungen durch Oder Operator in Feldern ===
Wenn das eine Feld leer ist nimm das nächste...
$t = $page->get("long_title|title");
=== Conditions für Navigation ===
<syntaxhighlight lang="php">
// If the page has children, then render navigation to them under the body.
// See the _func.php for the renderNav example function.
if($page->hasChildren) {
$content .= renderNav($page->children);
}
</syntaxhighlight>

<syntaxhighlight lang="php">
// if the rootParent (section) page has more than 1 child, then render
// section navigation in the sidebar
if($page->rootParent->hasChildren > 1) {
$sidebar = renderNavTree($page->rootParent, 3) . $page->sidebar;
}
</syntaxhighlight>
== Rendering ==
Es gibt viele Möglichkeiten deshalb ein eigenes Kapitel:
[[ProcessWire - Render Funktionen]]

== $page Object ==
Siehe auch [[ProcessWire - Page Object]]
=== Zugriff auf $page in Funktionen ===
Beispiel:
<pre>
function getTitle() {
$page = wire("page");
$t = $page->title;
</pre>
oder einfach übergeben.
=== Variablen zu Render-Datei senden ===
<pre>
// you can send vars (here item count)
// use this inside the field rendering script
// ie. $page->_n
$page->set('_n',$n);
$page->set('_type',$item->type);
$out .= $item->render();
</pre>

== Copy and Paste ==
=== Einfache Datumssteuerung ===
Setzt Felder date_begin und date_end voraus.
<syntaxhighlight lang="php">
// Date check
$dateValid = true;
$now = time();
$start = 0;
$end = 0;
if($page->date_begin){
$start = strtotime( $page->date_begin('Y-m-d') . " 00:00:00");
if( !($now >= $start) ) $dateValid = false;
}
if($page->date_end){
$end = strtotime( $page->date_end('Y-m-d') . " 23:59:59");
if( ($now > $end) ) $dateValid = false;
}

if(!$dateValid) return '';
</syntaxhighlight>

=== Copyright / Published Date ===
<pre>
$published_date = date('d.m.Y',$page->created);
<?= '©'.$published_date ?>
</pre>

=== Stylesheets und Skripte mit AIOM ===
<script src="<?php echo AIOM::JS(array('scripts/jquery-2.2.4.min.js','scripts/jquery.chocolat.js','scripts/jquery.fitvids.js','scripts/jquery.flexslider-min.js', 'scripts/main.js')); ?>"></script>
<link rel="stylesheet" type="text/css" href="<?php echo AIOM::CSS('styles/main.less'); ?>">
<?php echo $homepage->site_title .' '. Date('Y'); ?>

=== Link zur Seite anhand URL-Pfad ===
<?php echo $pages->get('/ueber-uns/')->url; ?>

=== Feld einer Seite ===
$content_left = $page->get('content_left');

=== Bild ===
if($page->main_image){$image = $page->main_image->size(640,960);}
else $image = NULL;
=== Bild von der Homepage ===
in _init.php
$homepage = $pages->get('/');
im Template
if($homepage->config_logo){$logo = $homepage->config_logo->width(280);}
else $logo = NULL;

=== Simple Navigation ===
<pre>
<ul class='nav-list'>
<?php
// Childrens
foreach(($page->children) as $item) {
if($item->id == $page->rootParent->id) {
echo '<li class="current">';
} else {
echo '<li>';
}
echo '<a class="ajax-link" href="'.$item->url.'">'.$item->title.'</a></li>';
}
?>
</ul>
</pre>

=== Auflistung mit div. Feldern aus Kindseiten ===
<syntaxhighlight lang="php">
/**
* Publications list template
*
*/
$publications = '';
$children = $page->children;
foreach($children as $child){
$publications .= '<div class="box">';
$publications .= '<h2><a class="ajax-link" parent="'. $child->parent->title .'" name="'.$child->title.'" href="'. $child->url. '">'. $child->title . '</a></h2>';
$publications .= $child->body;
$publications .= '</div>';
}

$content = $page->body . $publications;
</syntaxhighlight>

=== Minigalerie ===
Thumbnails / Child Pages
<syntaxhighlight lang="php">
$works = '<div class="gallery">';
$children = $page->children;
foreach($children as $child){
$works .= '<a class="ajax-link" parent="'. $child->parent->title .'" name="'.$child->title.'" href="'. $child->url. '">';
$works .= '<h2>'. $child->title . '</h2>';

if(count($child->thumbnail)){
$works .= '<div class="thumbnail"><img src="'. $child->thumbnail->getThumb('thumbnail') .'" title="'. $image->description .'"></div>';
}

$works .= '</a>';
}
$works .= '</div>';

$content = $page->body . $works . '<br/>' . $page->video;
</syntaxhighlight>

=== Page Navigation ===
<syntaxhighlight lang="php">
// add next button if there is another page next
if($page->next->id){
$next = '<div class="next"><i>Next:</i> <a class="ajax-link" name="'.$page->next->title.'" href="'. $page->next->url .'">'. $page->next->title .'<span class="fa fa-arrow-right"><span></a></div>';
}

$content = '<h2>'. $page->title . '</h2>' . $page->body . '<br/><div class="video">' . $page->video .'</div>' . $next;
</syntaxhighlight>

=== Simple Gallery with next Page ===
<syntaxhighlight lang="php">
$gallery = '<div class="gallery">';
$images = $page->gallery;

// add thumbnail to gallery
if(count($page->thumbnail)){
$gallery .= '<a class="chocolat-image gallery-item" href="'.$page->thumbnail->url.'"><img src="'. $page->thumbnail->getThumb('thumbnail') .'" title="'. $image->description .'"></a>';
}

foreach($images as $image){
$gallery .= '<a class="chocolat-image gallery-item" href="'.$image->url.'"><img src="'. $image->getThumb('thumbnail') .'" title="'. $image->description .'"></a> ';
}
$gallery .= '</div>';

// add next button if there is another page next
if($page->next->id){
$next = '<div class="next"><i>Next:</i> <a class="ajax-link" name="'.$page->next->title.'" href="'. $page->next->url .'">'. $page->next->title .'<span class="fa fa-arrow-right"><span></a></div>';
}

$content = '<h2>'. $page->title . '</h2>' . $page->body . '<br/>' . $gallery . '<br/><div class="video">' . $page->video .'</div>'. $next;

</syntaxhighlight>

=== Platzhalter-Seite mit Redirect auf erste Unterseite ===
Möchte man eine Eltern-Seite für das Menü generieren die keinen eigenen Inhalt besitzt sondern nur Unterseiten enthält, kann man ein Template für diese Seite erstellen, dass den User auf die erste Unterseite weiterleitet.

Diese Lösung ist ein regulärer Redirect. Ob das die Beste Lösung ist müßte man mal überlegen. Auf alle Fälle besser als Duplicate Content.
<syntaxhighlight lang="php">
<?php namespace ProcessWire;
$root = $pages->get("/");
if($page->numChildren){
$session->redirect($page->child()->url);
} else $session->redirect($root->url);
?>

</syntaxhighlight>

=== In Funktionen auf Page Objekt zugreifen ===
Entweder als Parameter übergeben (evtl. by reference) oder wenn ein ProcessWire Objekt in der Funktion vorliegt das vom Wire Objekt abgeleitet ist (fast alle) kannst du dieses nutzen:
$page = $items->wire('page'); // $items is a PageArray - use its wire to get current page

== ProcessWire - Debugging Snippets ==
[[ProcessWire - Debugging Snippets]]

Typo3 - Update

2025-04-15T11:33:26Z

109.193.152.88: /* Probleme lösen Version 7 */

Typo3 - Update

2025-04-15T11:32:29Z

109.193.152.88: /* Probleme lösen Version 7 */

== Links ==
http://wiki.typo3.org/Upgrade

[[TYPO3 - Troubleshooting Version 8]]
[[TYPO3 - Änderungen Version 9]]
== Aufräumen vor dem Update ==
http://typo3blogger.de/turchen-2-tutorial-typo3-entrumpeln/

=== Files ===
* kb_cleanfiles.
* Modul unter „DB-Überprüfung“ -> „Database Relations“. Neben dem Listing „Dateien, die in keinem Eintrag verwendet werden (bitte löschen!):“, welches der inhaltlichen Ausgabe der Extension sehr ähnelt, wird hier auch angezeigt ob Dateien doppelt referenziert werden
* typo3temp über install tool
=== Datenbank ===
* kj_recycler für papierkorb Daten danach refefence Index updaten
* cache_ Tabellen leeren
* sys_histroy leeren

Zur Not alles löschbar...

<pre>
[PHP]TRUNCATE TABLE sys_log //e.g. alle älter als 14 Tage
TRUNCATE TABLE sys_history //e.g. alle änderungen älter als 30 Tage

TRUNCATE TABLE index_fulltext
TRUNCATE TABLE index_grlist
TRUNCATE TABLE index_phash
TRUNCATE TABLE index_rel
TRUNCATE TABLE index_section
TRUNCATE TABLE index_stat_search
TRUNCATE TABLE index_stat_word
TRUNCATE TABLE index_words

TRUNCATE TABLE cache_pages
TRUNCATE TABLE cache_hash
TRUNCATE TABLE cache_imagesizes
TRUNCATE TABLE cache_pagesection
TRUNCATE TABLE cache_treelist
TRUNCATE TABLE cache_typo3temp_log
TRUNCATE TABLE cache_extensions

TRUNCATE TABLE tx_realurl_errorlog

TRUNCATE TABLE be_sessions
TRUNCATE TABLE fe_sessions
TRUNCATE TABLE fe_session_data[/PHP]

</pre>

== PHP Updates ==
=== PHP 5.5 2017 - Kurzanleitung ===
Kurzanleitung Update auf PHP 5.5 für TYPO3 4.5.x
<pre>
Wichtig
htaccess aktualisieren
Source aktualisieren
Umstellung utf8
- DB Export
- Textmate in utf-8 speichern
- Ersetzen von CHARSET=latin1 durch CHARSET=utf8
- Ersetzen der COLLATE
</pre>

localconf.php
=== PHP 5.6 2018 für TYPO 3 4.5 / 6.0===
Hinweis: 6.2 sollte laufen. Ältere Versionen sind ohnehin nicht mehr sicher.

Quelle:
http://www.typo3forum.net/discussion/79348/geloest-toolbaritem-shortcuts-must-implement-interface-backend-toolbaritem
https://www.typo3.net/forum/thematik/zeige/thema/123471/
Eine Suche im Netz ergab, dass T3 in der von mir verwendeten Version nicht mit PHP 5.6 kompatibel ist.

Unter diesem Link habe ich aber gefunden, wie man - bis zu einem Upgrade auf wenigstens 6.2 - das Backend wieder zum Laufen bekommt. Dazu müsste in folgenden Dateien über die Shell der Aufruf "&$backendReference" durch "$backendReference" ersetzt werden:

www/cms/typo3/classes/class.clearcachemenu.php:55:
www/cms/typo3/classes/class.livesearch.php:51:
www/cms/typo3/classes/class.shortcutmenu.php:79:
www/cms/typo3/interfaces/interface.backend_toolbaritem.php:43:
www/cms/typo3/sysext/opendocs/class.tx_opendocs.php:61:
www/cms/typo3/sysext/sys_action/toolbarmenu/class.tx_sysaction_toolbarmenu.php:53:
www/cms/typo3/sysext/sys_action/toolbarmenu/class.tx_sysaction_toolbarmenu.php:63:
www/cms/typo3/sysext/workspaces/Classes/BackendUserInterface/WorkspaceSelectorToolbarItem.php:59:

und zusätzlich noch

www/cms/typo3/classes/class.backendsearchmenu.php:52:
www/cms/typo3/classes/class.workspaceselector.php:57:
www/cms/typo3/sysext/workspaces/Classes/ExtDirect/WorkspaceSelectorToolbarItem.php:59

== Probleme lösen Version 7 ==
=== Update auf neuere Datenbanken Fehler: character set utf8 is not used for this connection ===
'''Potentielle Probleme:'''
* TYPO3 erwartet utf8 (genauer gesagt utf8mb3)
* TYPO3 7.6 geht standardmäßig von utf8_general_ci aus. Eine neuere Datenbank verwendet aber utf8mb3_general_ci – das ist funktional fast identisch mit dem alten utf8, aber durch neuere MySQL-Versionen expliziter gemacht. Trotzdem nicht 100 % dieselbe Bezeichnung → TYPO3 könnte das als Konflikt interpretieren.
* Verbindung läuft auf utf8mb4_unicode_ci Das ist ein 4-Byte-Zeichensatz, der nicht 100% kompatibel mit utf8mb3 ist. → Bei Sortierungen oder LIKE-Abfragen könnte TYPO3 falsche Ergebnisse bekommen (z. B. bei Umlauten, Emojis, Sonderzeichen). Ist aber i.d.R. nicht die Ursache für einen Datenbankfehler.
* Server-Default ist latin1_swedish_ci Dieser Zeichensatz ist alt und wird häufig von MySQL als Fallback verwendet. Gefährlich: Wenn irgendwo keine Zeichensatzangabe erfolgt (z. B. beim Import oder bei neuen Tabellen), wird automatisch latin1 genommen – und das zerstört Umlaute.

Lösungen:

== Update auf 7 ==
https://jweiland.net/video-anleitungen/typo3/typo3-projekte-verwalten/upgrade-typo3-62-auf-7.html
[[TYPO3 Update - 6 auf 7]]
https://jweiland.net/video-anleitungen/typo3/typo3-projekte-verwalten/typo3-7-lts-migration-von-css-styled-content-nach-fluid-styled-content.html
* css_styled_content wird durch fluid_styled_content ersetzt
* FSC bringt eigene CSS-Klassen für das Frontend mit. Anpassungen im CSS einer Website sind notwendig.
* Die Funktion "Rahmen und Einrückungen (section_frames)" gibt es nicht mehr. Hier muss bei Bedarf auf das "Layout"-Feld ausgewichen werden.
* Überschriften lassen sich nicht mehr direkt zentrieren oder rechts ausrichten.
* Die Bildeffekte (Drehung, Graustufen etc.) gibt es auch nicht mehr.

=== Fluid Styled Content ersetzt CSS Styled Content ===
[[TYPO3 - fluid_styled_content]]

=== htaccess für all-inkl TYPO3 v7===
So machts der Auto Installer:
<pre>
php_value always_populate_raw_post_data -1
php_value memory_limit 256M
php_value max_execution_time 240
<FilesMatch "\.(php.*|phtml)\.">
RewriteEngine on
RewriteRule .* - [R=403,L]
</FilesMatch>
#####
#
# Example .htaccess file for TYPO3 CMS - for use with Apache Webserver
#
# This file includes settings for the following configuration options:
#
# - Compression
# - Caching
# - MIME types
# - Cross Origin requests
# - Rewriting and Access
# - Miscellaneous
# - PHP optimisation
#
# If you want to use it, you have to copy it to the root folder of your TYPO3 installation (if its
# not there already) and rename it to '.htaccess'. To make .htaccess files work, you might need to
# adjust the 'AllowOverride' directive in your Apache configuration file.
#
# IMPORTANT: You may need to change this file depending on your TYPO3 installation!
# Consider adding this file's content to your webserver's configuration directly for speed improvement
#
# Lots of the options are taken from https://github.com/h5bp/html5-boilerplate/blob/master/dist/.htaccess
#
####

### Begin: Compression ###

# Compressing resource files will save bandwidth and so improve loading speed especially for users
# with slower internet connections. TYPO3 can compress the .js and .css files for you.
# *) Uncomment the following lines and
# *) Set $GLOBALS['TYPO3_CONF_VARS']['BE']['compressionLevel'] = 9 for the Backend
# *) Set $GLOBALS['TYPO3_CONF_VARS']['FE']['compressionLevel'] = 9 together with the TypoScript properties
# config.compressJs and config.compressCss for GZIP compression of Frontend JS and CSS files.

#<FilesMatch "\.js\.gzip$">
# AddType "text/javascript" .gzip
#</FilesMatch>
#<FilesMatch "\.css\.gzip$">
# AddType "text/css" .gzip
#</FilesMatch>
#AddEncoding gzip .gzip

<IfModule mod_deflate.c>
# Force compression for mangled `Accept-Encoding` request headers
<IfModule mod_setenvif.c>
<IfModule mod_headers.c>
SetEnvIfNoCase ^(Accept-EncodXng|X-cept-Encoding|X{15}|~{15}|-{15})$ ^((gzip|deflate)\s*,?\s*)+|[X~-]{4,13}$ HAVE_Accept-Encoding
RequestHeader append Accept-Encoding "gzip,deflate" env=HAVE_Accept-Encoding
</IfModule>
</IfModule>

# Compress all output labeled with one of the following media types.
#
# (!) For Apache versions below version 2.3.7 you don't need to
# enable `mod_filter` and can remove the `<IfModule mod_filter.c>`
# and `</IfModule>` lines as `AddOutputFilterByType` is still in
# the core directives.
#
# https://httpd.apache.org/docs/current/mod/mod_filter.html#addoutputfilterbytype

<IfModule mod_filter.c>
AddOutputFilterByType DEFLATE application/atom+xml \
application/javascript \
application/json \
application/ld+json \
application/manifest+json \
application/rdf+xml \
application/rss+xml \
application/schema+json \
application/vnd.geo+json \
application/vnd.ms-fontobject \
application/x-font-ttf \
application/x-javascript \
application/x-web-app-manifest+json \
application/xhtml+xml \
application/xml \
font/eot \
font/opentype \
image/bmp \
image/svg+xml \
image/vnd.microsoft.icon \
image/x-icon \
text/cache-manifest \
text/css \
text/html \
text/javascript \
text/plain \
text/vcard \
text/vnd.rim.location.xloc \
text/vtt \
text/x-component \
text/x-cross-domain-policy \
text/xml
</IfModule>

<IfModule mod_mime.c>
AddEncoding gzip svgz
</IfModule>
</IfModule>

### End: Compression ###

### Begin: Browser caching of resource files ###

# This affects Frontend and Backend and increases performance.
<IfModule mod_expires.c>

ExpiresActive on
ExpiresDefault "access plus 1 month"

ExpiresByType text/css "access plus 1 year"

ExpiresByType application/json "access plus 0 seconds"
ExpiresByType application/ld+json "access plus 0 seconds"
ExpiresByType application/schema+json "access plus 0 seconds"
ExpiresByType application/vnd.geo+json "access plus 0 seconds"
ExpiresByType application/xml "access plus 0 seconds"
ExpiresByType text/xml "access plus 0 seconds"

ExpiresByType image/vnd.microsoft.icon "access plus 1 week"
ExpiresByType image/x-icon "access plus 1 week"

ExpiresByType text/x-component "access plus 1 month"

ExpiresByType text/html "access plus 0 seconds"

ExpiresByType application/javascript "access plus 1 year"
ExpiresByType application/x-javascript "access plus 1 year"
ExpiresByType text/javascript "access plus 1 year"

ExpiresByType application/manifest+json "access plus 1 week"
ExpiresByType application/x-web-app-manifest+json "access plus 0 seconds"
ExpiresByType text/cache-manifest "access plus 0 seconds"

ExpiresByType audio/ogg "access plus 1 month"
ExpiresByType image/bmp "access plus 1 month"
ExpiresByType image/gif "access plus 1 month"
ExpiresByType image/jpeg "access plus 1 month"
ExpiresByType image/png "access plus 1 month"
ExpiresByType image/svg+xml "access plus 1 month"
ExpiresByType image/webp "access plus 1 month"
ExpiresByType video/mp4 "access plus 1 month"
ExpiresByType video/ogg "access plus 1 month"
ExpiresByType video/webm "access plus 1 month"

ExpiresByType application/atom+xml "access plus 1 hour"
ExpiresByType application/rdf+xml "access plus 1 hour"
ExpiresByType application/rss+xml "access plus 1 hour"

ExpiresByType application/vnd.ms-fontobject "access plus 1 month"
ExpiresByType font/eot "access plus 1 month"
ExpiresByType font/opentype "access plus 1 month"
ExpiresByType application/x-font-ttf "access plus 1 month"
ExpiresByType application/font-woff "access plus 1 month"
ExpiresByType application/x-font-woff "access plus 1 month"
ExpiresByType font/woff "access plus 1 month"
ExpiresByType application/font-woff2 "access plus 1 month"

ExpiresByType text/x-cross-domain-policy "access plus 1 week"

</IfModule>

### End: Browser caching of resource files ###

### Begin: MIME types ###

# Proper MIME types for all files
<IfModule mod_mime.c>

# Data interchange
AddType application/atom+xml atom
AddType application/json json map topojson
AddType application/ld+json jsonld
AddType application/rss+xml rss
AddType application/vnd.geo+json geojson
AddType application/xml rdf xml

# JavaScript
AddType application/javascript js

# Manifest files
AddType application/manifest+json webmanifest
AddType application/x-web-app-manifest+json webapp
AddType text/cache-manifest appcache

# Media files

AddType audio/mp4 f4a f4b m4a
AddType audio/ogg oga ogg opus
AddType image/bmp bmp
AddType image/svg+xml svg svgz
AddType image/webp webp
AddType video/mp4 f4v f4p m4v mp4
AddType video/ogg ogv
AddType video/webm webm
AddType video/x-flv flv
AddType image/x-icon cur ico

# Web fonts
AddType application/font-woff woff
AddType application/font-woff2 woff2
AddType application/vnd.ms-fontobject eot
AddType application/x-font-ttf ttc ttf
AddType font/opentype otf

# Other
AddType application/octet-stream safariextz
AddType application/x-bb-appworld bbaw
AddType application/x-chrome-extension crx
AddType application/x-opera-extension oex
AddType application/x-xpinstall xpi
AddType text/vcard vcard vcf
AddType text/vnd.rim.location.xloc xloc
AddType text/vtt vtt
AddType text/x-component htc

</IfModule>

# UTF-8 encoding
AddDefaultCharset utf-8
<IfModule mod_mime.c>
AddCharset utf-8 .atom .css .js .json .manifest .rdf .rss .vtt .webapp .webmanifest .xml
</IfModule>

### End: MIME types ###

### Begin: Cross Origin ###

# Send the CORS header for images when browsers request it.
<IfModule mod_setenvif.c>
<IfModule mod_headers.c>
<FilesMatch "\.(bmp|cur|gif|ico|jpe?g|png|svgz?|webp)$">
SetEnvIf Origin ":" IS_CORS
Header set Access-Control-Allow-Origin "*" env=IS_CORS
</FilesMatch>
</IfModule>
</IfModule>

# Allow cross-origin access to web fonts.
<IfModule mod_headers.c>
<FilesMatch "\.(eot|otf|tt[cf]|woff2?)$">
Header set Access-Control-Allow-Origin "*"
</FilesMatch>
</IfModule>

### End: Cross Origin ###

### Begin: Rewriting and Access ###

# You need rewriting, if you use a URL-Rewriting extension (RealURL, CoolUri).

<IfModule mod_rewrite.c>

# Enable URL rewriting
RewriteEngine On

# Store the current location in an environment variable CWD to use
# mod_rewrite in .htaccess files without knowing the RewriteBase
RewriteCond $0#%{REQUEST_URI} ([^#]*)#(.*)\1$
RewriteRule ^.*$ - [E=CWD:%2]

# Rules to set ApplicationContext based on hostname
#RewriteCond %{HTTP_HOST} ^dev\.example\.com$
#RewriteRule .? - [E=TYPO3_CONTEXT:Development]
#RewriteCond %{HTTP_HOST} ^staging\.example\.com$
#RewriteRule .? - [E=TYPO3_CONTEXT:Production/Staging]
#RewriteCond %{HTTP_HOST} ^www\.example\.com$
#RewriteRule .? - [E=TYPO3_CONTEXT:Production]

# Rule for versioned static files, configured through:
# - $GLOBALS['TYPO3_CONF_VARS']['BE']['versionNumberInFilename']
# - $GLOBALS['TYPO3_CONF_VARS']['FE']['versionNumberInFilename']
# IMPORTANT: This rule has to be the very first RewriteCond in order to work!
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^(.+)\.(\d+)\.(php|js|css|png|jpg|gif|gzip)$ %{ENV:CWD}$1.$3 [L]

# Access block for folders
RewriteRule _(?:recycler|temp)_/ - [F]
RewriteRule fileadmin/templates/.*\.(?:txt|ts)$ - [F]
RewriteRule ^(?:vendor|typo3_src|typo3temp/logs) - [F]
RewriteRule (?:typo3conf/ext|typo3/sysext|typo3/ext)/[^/]+/(?:Configuration|Resources/Private|Tests?|Documentation|docs?)/ - [F]

# Block access to all hidden files and directories with the exception of
# the visible content from within the `/.well-known/` hidden directory (RFC 5785).
RewriteCond %{REQUEST_URI} "!(^|/)\.well-known/([^./]+./?)+$" [NC]
RewriteCond %{SCRIPT_FILENAME} -d [OR]
RewriteCond %{SCRIPT_FILENAME} -f
RewriteRule (?:^|/)\. - [F]

# Stop rewrite processing, if we are in the typo3/ directory or any other known directory
# NOTE: Add your additional local storages here
RewriteRule ^(?:typo3/|fileadmin/|typo3conf/|typo3temp/|uploads/|favicon\.ico) - [L]

# If the file/symlink/directory does not exist => Redirect to index.php.
# For httpd.conf, you need to prefix each '%{REQUEST_FILENAME}' with '%{DOCUMENT_ROOT}'.
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME} !-l
RewriteRule ^.*$ %{ENV:CWD}index.php [QSA,L]

</IfModule>

# Access block for files
<FilesMatch "(?i:^\.|^#.*#|^(?:ChangeLog|ToDo|Readme|License)(?:\.md|\.txt)?|^composer\.(?:json|lock)|^ext_conf_template\.txt|^ext_typoscript_constants\.txt|^ext_typoscript_setup\.txt|flexform[^.]*\.xml|locallang[^.]*\.(?:xml|xlf)|\.(?:bak|co?nf|cfg|ya?ml|ts|dist|fla|in[ci]|log|sh|sql(?:\..*)?|sw[op]|git.*)|.*(?:~|rc))$">
# Apache < 2.3
<IfModule !mod_authz_core.c>
Order allow,deny
Deny from all
Satisfy All
</IfModule>

# Apache ≥ 2.3
<IfModule mod_authz_core.c>
Require all denied
</IfModule>
</FilesMatch>

# Block access to vcs directories
<IfModule mod_alias.c>
RedirectMatch 404 /\.(?:git|svn|hg)/
</IfModule>

### End: Rewriting and Access ###

### Begin: Miscellaneous ###

# 404 error prevention for non-existing redirected folders
Options -MultiViews

# Make sure that directory listings are disabled.
<IfModule mod_autoindex.c>
Options -Indexes
</IfModule>

<IfModule mod_headers.c>
# Force IE to render pages in the highest available mode
Header set X-UA-Compatible "IE=edge"
<FilesMatch "\.(appcache|crx|css|eot|gif|htc|ico|jpe?g|js|m4a|m4v|manifest|mp4|oex|oga|ogg|ogv|otf|pdf|png|safariextz|svgz?|ttf|vcf|webapp|webm|webp|woff2?|xml|xpi)$">
Header unset X-UA-Compatible
</FilesMatch>

# Reducing MIME type security risks
Header set X-Content-Type-Options "nosniff"
</IfModule>

# ETag removal
<IfModule mod_headers.c>
Header unset ETag
</IfModule>
FileETag None

### End: Miscellaneous ###

# Add your own rules here.

</pre>

== Update auf 6.2 ==
=== Probleme mit dem index ===
https://forge.typo3.org/issues/61154

'''Fehlermeldung''' "Migrate all file links of RTE-enabled fields to FAL" fails with "Reference index was probably out of date."

Description

Meanwhile I did upgrades from TYPO3 4.7 to 6.2 for three different instances and every time I ran into this problem.
Reason are links in content elements of hidden or (from database point of view: logical) deleted pages where the target (usually the file in fileadmin) does not exist anymore.

cli_dispatch.phpsh lowlevel_refindex -c

does not detect these broken links. So this is a deadlock during migration.

I found this workaround which requires using a SQL client for the mysql database:
1) '''check''' if the result of this query matches the list of "Reference index was probably out of date" elements

select * from sys_refindex where softref_key = 'typolink_tag' AND ref_table = '_FILE';

2) If so you can '''update''' these records:

update sys_refindex set softref_key = 'typolink' where softref_key = 'typolink_tag' AND ref_table = '_FILE';

== Update 4.5 , 4.7 ==
=== Umlautprobleme ===
evtl. auch mal bei dbinit
<pre>
SET character_set_client = utf8;
SET character_set_results = utf8;
SET character_set_connection = utf8;
</pre>

Manchmal auch bei Darstellungsproblemen oder weißer Seite

Install-Tool nach dem Parameter "
systemLocale -> de_DE.utf8
'''Bis TYPO3 4.6''': im Install-Tool den Parameter
forceCharset -> utf-8
'''Ab TYPO3 4.7''': im '''Typoscript-Setup'''
config.renderCharset = utf-8
Im '''Install-Tool''' bei "
setDBinit -> SET NAMES utf8;
eintragen (ist ab TYPO3 4.7 bereits als Standard eingetragen).

Nun den kompletten Cache leeren. Jetzt sollten die Umlaute korrekt dargestellt werden.
</pre>
Falls Sie per GIFBUILDER Text in Bilder einbauen, versuchen Sie folgendes:
<pre>
Im Install-Tool beim Parameter "t3lib_cs_convMethod" den Wert "mbstring" eintragen.
Im Install-Tool beim Parameter "t3lib_cs_utils" ebenfalls " mbstring" eintragen.
</pre>
Falls Sie Templavoila verwenden, müssen Sie darauf achten, dass Ihr HTML-Editor die Datei UTF-8-kodiert speichert. In den meisten Editoren können Sie das in den Einstellungen anpassen.

Wenn immer noch Darstellungsprobleme auftreten, kann unter Umständen eine Konvertierung der Datenbank nötig sein.

== Update Infos 4.5 ==
* Weitere Tools werden separat installiert
* utf-8 für Datenbankverbindung wird vorausgesetzt (siehe auch Typo3 auf utf-8 umstellen)
** Install-Tool $TYPO3_CONF_VARS['SYS']['setDBinit'] und $TYPO3_CONF_VARS['BE']['forceCharset'] default haben sich verändert.

* Zugriff auf veraltete php-Funktionen werden geloggt. Vorsichtig Log kann groß werden
* Extbase und Fluid

== Update Infos 4.3 ==
* simulate_static_docs muss separat installiert werden
=== Update Wizard Info ===
'''CSS Styled Content: Default targets for non-frame pages'''

The default page target is empty (so no target is generated). If you use frames, you have to set target to "page" in Constants.

'''CSS Styled Content: htmlspecialchars in menu content elements'''

Page titles will get htmlspecialchar'ed when rendered in "Sitemap/menu" content elements, to avoid generating invalid XHTML.

'''htmlArea RTE: Using CSS classes for indentation and alignment'''

* Indentation is produced by a CSS class instead of the blockquote element.
You will need to specify in Page TSConfig the class to be used for indentation using property buttons.indent.useClass (default is "indent"). You will need to define this class in your stylesheets and ensure that it is allowed by the RTE transformation (RTE.default.proc). Alternatively, you may continue using the blockquote element by setting property buttons.indent.useBlockquote. You may also want to add the new blockquote button to the RTE toolbar.

* Text alignment is produced by CSS classes instead of deprecated align attribute.
You will need to specify in Page TSConfig the class to be used for each text alignment button using property buttons.[left, center, right or justifyfull].useClass (defaults are "align-left", "align-center", "align-right", "align-justify"). You will need to define these classes in your stylesheets, and ensure that they are allowed by the RTE transformation (RTE.default.proc). Alternatively, you may continue using deprecated align attribute by setting property buttons.[left, center, right or justifyfull].useAlignAttribute.

== Update alter Typo3 Installationen (<V.3.8)==
Aus der Mailing Liste Östereich:
- der Core ist relativ easy (fast) immer zu upgraden (muesst' eigentlich von
v3.3 auch gehen ;-) )
- Achte immer auf installierte Extensions
* wenn etwas nicht geht, mal soweit wie moeglich alle Extensions wegschalten (nicht loeschen!).
* dann zuschalten; wenns dann hakt, dann sieht man gleich welche ext "boese" ist.
* dann diese ext updaten, wenns keine updates gibt, mal danach googlen.
* wenns dann net geht, debuggen..

Weitere Probleme:

Alte TS Templates arbeiten noch mit CSet und Content als default Template. Nach umstellen auf css-styled-content muß evt. einiges angepasst werden:
== Update auf 4.2 ==
<pre>
Backup erstellen (sollte selbstverständlich sein)!
Notieren welche Extensions "Global" installiert wurden, da diese später wieder erneut installiert werden müssen
Resource herunterladen:
wget kent.dl.sourceforge.net/sourceforge/typo3/typo3_src-4.2.8.tar.gz
Source-Paket entpacken:
tar -xzf typo3_src-4.2.8.tar.gz
Im Verzeichnis typo3conf müssen Sie eine Datei mit dem Namen "ENALBE_INSTALL_TOOL" erstellen bzw. uploaden (ich mache das immer mit vi ENABLE_INSTALL_TOOL )
eventuell die Rechte und die Gruppe ändern
eventuell basedir_restriction anpassen (für Plesk siehe hier)
typo3_src Symlink löschen:
rm typo3_src
neuen Symlink anlegen:
ln -s ../../typo3_src-4.2.8/ typo3_src
(den richtigen Pfad zum Source-Verzeichnis eventuell anpassen)
index.php löschen und neu erstellen:
rm index.php
ln -s typo3_src/index.php index.php
alte Verzeichnisse löschen (media, tslib)
alte Dateien löschen (showpic.php)
fehlende Verzeichnisse erstellen:
typo3conf/l10n, typo3temp/temp, typo3temp/GB, typo3temp/pics, typo3temp/llxml/, typo3temp/cs/ (sofern diese nicht schon vorhanden sind)
Installtool aufrufen und "Basic Configuration" überprüfen; hier sollte alles im grünen Bereich sein. Wenn nicht entsprechende Probleme beheben.
"Update Wizard" ausführen
Im "Database Analyser" auf "Update required tables" auf "Compare" klicken und bestätigen
Ins Backend einloggen und alle "Global" installierten Extensions nachinstallieren
Im Ext Manager unter Settings "Enable unsupported extensions" aktivieren, da zur Zeit noch nicht alle Exentensions überprüft wurden.
Im Ext Manager unter "Import extensions" auf "Retrieve/Update" klicken, um die aktuelle Liste der Extensions herunterzuladen
(Sollte es dabei zu Fehlermeldungen kommen, muss u.U. auf curl umgestellt werden) Leider ist das neue TER 2.0 extrem speicherhungrig, so dass u.U. die Speicherbeschränkung von PHP nicht ausreicht. Wenn möglich sollten Sie also zuvor den verfügbaren Speicher von PHP auf min. 45MB(!) hochsetzen. Sollten Sie dazu keine Rechte haben oder soviel Speicher nicht zur Verfügung stellen wollen, können Sie sich dadurch behelfen, dass Sie die benötigten Extensions als .t3x-Dateien herunterladen und "von Hand" installieren.
Im Ext Manager die Sprache updaten
Eventuell veraltete local-installierte Extensions erneuern (z.B. TemplaVoila, static_info_tables u.ä.)
Nicht mehr benötigte "Local"-installierte Extensions entfernen, wie z.B. csh_de, htmlarea (ist jetzt eine "System"-Extension und sollte daher local deinstalliert werden)
</pre>
== Update auf 4.1 ==
Unbedingt im Install Tool Compare ausführen und Tabellen aktualisieren. Sonst kann es Probleme mit verschiedenen Extensions geben (z.B. Login..)

== Probleme beim TYPO3 Update lösen ==
=== Weiße Seite ===
* Fehlermeldungen einschalten
=== The requested URL /typo3/alt_main.php was not found on this server.===
Symlink für index.php falsch
=== Nach dem Datenbank Compare fehlen Teile der TYPOScript Templates ===

'''Lösung'''

Von Version 4.2 auf 4.1 werden blob Felder zu Text Feldern umgewandelt. Dabei werden bei Umlauten die Inhalte abgeschnitten, wenn die Datenbank utf-8 arbeitet, TYPO3 aber die Daten in latin abgelegt hat.

Beim Compare muß man dann die blob konvertierungen weglassen (vor allem bei den Templates - in der Regel gibt es da Kommentare mit Umlauten) und leicht abgewandelt selbst durchführen:

ALTER TABLE sys_template CHANGE config config TEXT CHARACTER SET latin1;

Typo3 läßt hier die Angabe welcher Zeichensatz drin ist weg.

Die wichtigsten Statements (Stand Typo3 4.5):

<pre>
ALTER TABLE sys_template CHANGE constants constants text CHARACTER SET latin1;
ALTER TABLE sys_template CHANGE config config text CHARACTER SET latin1;
ALTER TABLE tt_content CHANGE image image text CHARACTER SET latin1;
ALTER TABLE tt_content CHANGE media media text CHARACTER SET latin1;
ALTER TABLE tt_content CHANGE pages pages tinytext CHARACTER SET latin1;
ALTER TABLE tt_content CHANGE multimedia multimedia tinytext CHARACTER SET latin1;
ALTER TABLE pages CHANGE media media text CHARACTER SET latin1;
</pre>

Link: http://dev.mysql.com/doc/refman/5.1/en/alter-table.html (Zugriff: 10/2012)

== Release Notes Version 4.1 ==
Die wichtigsten Neuerungen
* IRRE (Inline Relational Record Editing)
* AJAX Page and File Tree
* Clean-up functions (command line scripts)(Über Extension lowlevel)
* Improved Extension Manager (less memory, stored extension list)
* UTF-8 for filenames
* Backend "Who is online"
* Frontend "Stay logged in" (Konfiguration mit new login box)
* MySQL InnoDB (Wird automatisch bei Neuinstallation zur Verfügung gestellt, wenn es in mySQL aktiviert ist)
* Speed up Backend with .htaccess http://typo3.org/development/articles/release-notes-41/page/4/)

=== Manuelles ändern der Tabellen auf InnoDB ===
Hinweis persönlich rate ich von INNODB und TYPO3 ab, besser ISAM nehmen
<pre>
alter table cache_hash ENGINE = INNODB;
alter table cache_imagesizes ENGINE = INNODB;
alter table cache_md5params ENGINE = INNODB;
alter table cache_pages ENGINE = INNODB;
alter table cache_pagesection ENGINE = INNODB;
alter table cache_typo3temp_log ENGINE = INNODB;
alter table fe_sessions ENGINE = INNODB;
alter table fe_session_data ENGINE = INNODB;
alter table index_fulltext ENGINE = INNODB;
alter table index_grlist ENGINE = INNODB;
alter table index_phash ENGINE = INNODB;
alter table index_rel ENGINE = INNODB;
alter table index_section ENGINE = INNODB;
alter table index_stat_search ENGINE = INNODB;
alter table index_stat_word ENGINE = INNODB;
alter table index_words ENGINE = INNODB;
alter table sys_log ENGINE = INNODB;
</pre>

== Generelle Informationen zum Update unter Linux ==
Quelle: typo3.net Mai 2006

Typo3 ist normalerweise sehr einfach upzudaten - allerdings müssen ein paar Dinge beachtet werden, um updatefähig zu bleiben:

* Es dürfen keine Änderungen an dem Typo3-Sourcecode gemacht worden sein. Falls dieses doch gemacht wurde, müssen natürlich diese Änderungen erst in die neue Version eingearbeitet werden.
* Installierte Extensions sollten möglichst immer LOCAL installiert worden sein. So bleiben diese nach dem Tausch des Typo3-Sourcecodes unberührt und funktionieren nach dem Update (meist) wie gewohnt. Es gibt nur selten den Fall, daß eine Typo3-Version eine Funktion nicht mehr verwendet, die es in der alten Version noch gab.
* Wenn sie HTML-Templates von GLOBAL installierten Erweiterungen direkt im Extensionordner modifiziert haben sollten, müssen diese erst z.B. in den fileadmin kopiert werden. Dann können Sie den Pfad zu dieser Datei im TypoScript anpassen.

Den Pfad finden Sie überigens mithilfe des TypoScript-Object-Browsers schnell. Meist ist er an der Stelle plugin.extensionname.templateFile zu finden.

[[Bild:T3_wichtigeVerzeichnisse.gif]]

Einige der wichtigsten Verzeichnisse

'''Das Update für mittwaldmedien Kunden'''
Für unsere Kunden ist es nun besonders einfach, die vorhandene Installation auf die aktuelle Version zu bringen. Sie müssen sich nur auf der Webseite http://www.typo3server.com einloggen. Nach dem Login finden Sie ein Menü mit einem Link zu dem Typo3-Versionsmanager. Dort können Sie mit einem Klick Ihren Account auf die neue Version updaten.

'''ToDo Versionsmanager für Geo-bit'''

'''Manuelles Update'''

Für diejenigen, die dieses Update manuell machen wollen oder müssen, sind die folgenden Schrittenötig. Die Beispiele - vor allem die Pfade - müssen natürlich angepasst werden. Die Beispiele gehen davon aus, daß Sie eine Verzeichnisstruktur angelegt haben, die dem obigen Bild entspricht.

1. Machen Sie zuerst eine Datensicherung von dem Typo3-Sourcen und Ihrem html-Ordner! Die Datenbank können Sie nun über diesen Befehl sichern:

mysqldump -u benutzername -p -B --add-drop-table datenbank > typo3DBSicherung.sql

Notfalls könnte auch ein Dump mit phpMyAdmin erstellt werden.

2. Verbinden Sie sich mit Ihrem Server über SSH.

3. Wechseln Sie das Verzeichnis auf einer Ebene über dem Rootverzeichnis Ihres Webservers.
z.B.: cd /home/www/p1234/

4. Laden Sie sich die neuen Typo3-Sourcen auf ihren Linuxrechner. Die aktuellen Sourcen finden Sie unter: http://typo3.org/download/packages/.

Die benötigte Datei hat das Format typo3_src-3.x.x.tar.gz

'''Beispiel:'''

wget belnet.dl.sourceforge.net/sourceforge/typo3/typo3_src-3.7.0.tar.gz

5. Entpacken Sie die Datei mit dem Kommando:

'''Beispiel:'''

tar -xzvf typo3_src-3.x.x.tar.gz

6. Ändern Sie nun die Rechte so, wie der bisherige Typo3-Sourcecode-Ordner sie hatte.

'''Beispiel:'''

chown p1234.ftponly typo3_src-3.7.0 -R

7. Entfernen Sie den alten symbolischen Link mit:

rm typo3_src

8. Legen Sie nun einen neuen Link an mit:

ln -s typo3_src-3.x.x typo3_src

(Die Versionsnummer müssen Sie natürlich noch anpassen.)

9. Nun muss die Datenbank noch aktualisiert werden:

Gehen Sie hierzu in das Typo3-Installtool und klicken Sie auf den 2. Menüpunkt Database Analyser. Mit einem Klick auf Compare werden die zu ändernden oder zu ergänzenden Datenbankfelder angezeigt. Mit einem Klick auf "Write to database" wird die Datenbank an die neue Typo3-Version angepasst.

10. Loggen Sie sich nun als Admin im Backend an und löschen Sie alle Caches.

== Neu in Version 4 ==
* Conditions mit AND und OR (|| &&)

== Neu in 4.2 ==
Viele Usability Verbesserungen im Backend
== Update auf 4.2 ==
=== Extensions Updaten ===
* dam 1.0.11 ist nicht kompatibel Update auf min. 1.0.13
* date2cal auf >= 7.1.0
* Kickstarter 0.3.8 ist nicht kompatibel
* Developer tools gehen nicht mehr (wg. Frame oben)

=== Ablauf ===
* Backend Benutzer sperren (only Admins)
* Sicherung der Datenbank
* neue Source + Symlink
* Update Wizard
* Compare

=== Probleme ===
'''DAM Upload geht für Benutzer''' nicht mehr (Fehler Meta Daten können nicht geschrieben werden)
Beim neu indizieren geht dem dam der Media Ordner verloren. Er legt dann einen neuen an, in den er scheiben möchte. Die Benutzer sind abe noch auf den alten eingestellt. D.h. die Benutzergruppen m´üssen auf den neuen eingestellt werden.

Im Dam stehen im IE7 die Benutzerwerkzeuge nicht zur verfügung (löschen etc.) nur der Stift ist noch da.

Lösung: Das Problem ist das CSS für das Fenster. Es verdeckt die restlichen Symbole
Forum: 24.7.

Ich hatte das gleiche Problem bis vor 5 Minuten auch,
gelöst habe ich es so:
- Datei: class.tx_dam_listbase.php im Ordner DAM\lib\
Unter der Zeile 256 ('itemTD' => ' class="typo3-dblist-item"',)
ist in 3 Werten als Breite 1% angegeben. Das auskommentieren

- Datei: stylesheet.cdd in typo3_src\typo3\
table.typo3-dblist width: 98%; durch width: auto; ersetzen und in
table.typo3-dblist tr td {width: auto;} einsetzen,

damit hats bei mir im IE 7, Firefox, safari für Win und Opera alles richtig angezeigt :-)

Ich hoffe, geholrfen zu haben,
Schmoozer

Bug in Mount Points

== Datenbank über Root Shell sichern (mysql backup) ==

mysqldump -opt ...

Beispiele

Die häufigste Anwendung von mysqldump ist wahrscheinlich die '''Erstellung eines Backups einer vollständigen Datenbank''':

shell> mysqldump --opt db_name > backup-file.sql

oder mit User und Passwortangabe:
mysqldump -u meinDBUser -pGEHEIM db_name > backup.sql

--opt ist in neueren MySQL Versionen Standardmäßig an deshalb lassen wir es mal weg.

Die Speicherauszugsdatei können Sie wie folgt '''wieder einspielen'''.

shell> mysql db_name < backup-file.sql

Oder aber so:

shell> mysql -e "source /path-to-backup/backup-file.sql" db_name

mysqldump ist ferner sehr nützlich zum Ausfüllen von Datenbanken durch Kopieren von Daten von einem MySQL Server auf einen anderen:

shell> mysqldump --opt db_name | mysql --host=remote_host -C db_name

Sie können mit einem einzigen Befehl einen Speicherauszug mehrerer Datenbanken erstellen:

shell> mysqldump --databases db_name1 [db_name2 ...] > my_databases.sql

Um einen Speicherauszug aller Datenbanken zu erstellen, verwenden Sie die Option --all-databases:

shell> mysqldump --all-databases > all_databases.sql

Bei InnoDB-Tabellen bietet mysqldump die Möglichkeit, eine Online-Sicherung zu erstellen:

shell> mysqldump --all-databases --single-transaction > all_databases.sql

Diese Datensicherung muss vor Beginn des Speicherauszugsvorgangs lediglich (mit FLUSH TABLES WITH READ LOCK) eine globale Lesesperre für alle Tabellen erwirken. Sobald diese Sperre aktiv ist, werden die Koordinaten des Binärlogs ausgelesen, und die Sperre wird aufgehoben. Wenn beim Absetzen der FLUSH-Anweisung gerade eine umfangreiche Änderungsanweisung ausgeführt wird, dann – und nur dann! – kann der MySQL Server stehen bleiben, bis diese lange Anweisung ausgeführt ist; danach ist der Server sperrfrei. Wenn die vom MySQL Server empfangenen Änderungsanweisungen (in Bezug auf ihre Ausführungsdauer) kurz sind, sollte die anfängliche Sperrperiode auch bei vielen Änderungen nicht spürbar sein.

Bei der Point-in-Time-Wiederherstellung (die auch als „Roll-Forward“ bezeichnet wird, wenn Sie ein altes Backup wiederherstellen und die seitdem durchgeführten Änderungen neu aufspielen müssen) ist es häufig nützlich, das Binärlog zu rotieren (siehe Abschnitt 5.12.3, „Die binäre Update-Logdatei“) oder zumindest die Binärlogkoordinaten zu kennen, denen der Speicherauszug entspricht:

shell> mysqldump --all-databases --master-data=2 > all_databases.sql

Oder:

shell> mysqldump --all-databases --flush-logs --master-data=2
> all_databases.sql

== Mass Update Script ==

Yesterday some updates came out for TYPO3. These updates fixed certain issues and we needed to update all of our excellent shared hosting environments.

We already have a script (which is more elaborate now) that checks all our TYPO3 installations and sends the sysadmins a nice report about its findings. We use part of that report (list of paths to Document Roots) to feed the updater script.

The TYPO3 update requires you to do the followi

* update encryption key
* clear configuration cache
* clear page cache

We do not want to go into 200+ TYPO3 backends and do those tasks manually. We are lazy and we will write a script to automagically do the boring tasks for us.

This script is not perfect but it works well on Debian systems. You can modify it to fit your needs. It was just a quick hack to ease the upgrade pain. Take care to switch the symlink part for upgrade runs of different versions of TYPO3.

I am not responsible for any damage to your system that may occur to misuse of this script. Make sure you understand it before you run it. Run it with a single URI before attempting a whole ist of URI's.

Ein Massen Update Script von:

http://typofree.org/article/archive/2009/january/title/typo3-mass-upgrade-script/
Zugriff am 12.3.2009

http://typofree.org/article/archive/2009/january/title/typo3-mass-upgrade-script/

TYPO3 mass update script

1.
#!/bin/sh
2.
binDir=/usr/bin/
3.
sleep=2
4.

5.
pageCacheTables=(
6.
cache_pages
7.
cache_pagesection
8.
)
9.

10.
sites=(
11.
/var/www/sites/live/www.somedomain.tld
12.
/var/www/sites/live/www.someotherdomain.tld
13.
/var/www/sites/live/www.yetsomeotherdomain.tld
14.
)
15.

16.
len=${#sites[*]}
17.
pageCacheTablesLength=${#pageCacheTables[*]}
18.
i=0
19.
while [ $i -lt $len ]; do
20.
echo updating: ${sites[$i]}
21.
cd ${sites[$i]}
22.
rm typo3_src
23.
ln -s ../../sources/typo3_src-4.2.5 typo3_src
24.

25.
echo generating new key
26.
k=0
27.
key=''
28.
while [ $k -lt 96 ]; do
29.
key=$key$(head -100 /dev/urandom | md5sum | cut -c1)
30.
let k++
31.
done
32.
echo key: $key
33.
sed -i "s/$\$TYPO3_CONF_VARS\['SYS']\['encryptionKey'] = $.*/\1'$key';/g" typo3conf/localconf.php
34.

35.
echo removing configuration cache
36.
rm -f typo3conf/temp_CACHED*
37.

38.
echo clearing page cache
39.
# For some insane reason some values are enclosed in double qotes
40.
database=$(grep "typo_db " typo3conf/localconf.php | tail -1 | sed "s/^[^']*'$[^']*$'.*/\1/" | grep '$typo_db =')
41.
if [ -z "$database" ] ; then
42.
database=$(grep "typo_db " typo3conf/localconf.php | tail -1 | sed "s/^[^']*'$[^']*$'.*/\1/")
43.
else
44.
database=$(grep "typo_db " typo3conf/localconf.php | tail -1 | sed "s/^[^\"]*\"$[^\"]*$\".*/\1/")
45.
fi
46.
username=$(grep "typo_db_username " typo3conf/localconf.php | tail -1 | sed "s/^[^']*'$[^']*$'.*/\1/" | grep '$typo_db_username =')
47.
if [ -z "$username" ] ; then
48.
username=$(grep "typo_db_username " typo3conf/localconf.php | tail -1 | sed "s/^[^']*'$[^']*$'.*/\1/")
49.
else
50.
username=$(grep "typo_db_username " typo3conf/localconf.php | tail -1 | sed "s/^[^\"]*\"$[^\"]*$\".*/\1/")
51.
fi
52.
password=$(grep "typo_db_password " typo3conf/localconf.php | tail -1 | sed "s/^[^']*'$[^']*$'.*/\1/" | grep '$typo_db_password =')
53.
if [ -z "$password" ] ; then
54.
password=$(grep "typo_db_password " typo3conf/localconf.php | tail -1 | sed "s/^[^']*'$[^']*$'.*/\1/")
55.
else
56.
password=$(grep "typo_db_password " typo3conf/localconf.php | tail -1 | sed "s/^[^\"]*\"$[^\"]*$\".*/\1/")
57.
fi
58.
j=0
59.
while [ $j -lt $pageCacheTablesLength ];
60.
do
61.
nice -n 19 ${binDir}mysql --batch -u$username -p"$password" -D$database -e "TRUNCATE ${pageCacheTables[$j]}"
62.
nice -n 19 ${binDir}mysql --batch -u$username -p"$password" -D$database -e "ALTER TABLE ${pageCacheTables[$j]} auto_increment=1"
63.
let j++
64.
done
65.

66.
echo "done! Sleeping $sleep seconds . . ."
67.
sleep $sleep
68.

69.
echo
70.
let i++
71.
done

Typo3 - Update

2025-04-15T11:30:21Z

109.193.152.88: /* Update auf 7 */

== Links ==
http://wiki.typo3.org/Upgrade

[[TYPO3 - Troubleshooting Version 8]]
[[TYPO3 - Änderungen Version 9]]
== Aufräumen vor dem Update ==
http://typo3blogger.de/turchen-2-tutorial-typo3-entrumpeln/

=== Files ===
* kb_cleanfiles.
* Modul unter „DB-Überprüfung“ -> „Database Relations“. Neben dem Listing „Dateien, die in keinem Eintrag verwendet werden (bitte löschen!):“, welches der inhaltlichen Ausgabe der Extension sehr ähnelt, wird hier auch angezeigt ob Dateien doppelt referenziert werden
* typo3temp über install tool
=== Datenbank ===
* kj_recycler für papierkorb Daten danach refefence Index updaten
* cache_ Tabellen leeren
* sys_histroy leeren

Zur Not alles löschbar...

<pre>
[PHP]TRUNCATE TABLE sys_log //e.g. alle älter als 14 Tage
TRUNCATE TABLE sys_history //e.g. alle änderungen älter als 30 Tage

TRUNCATE TABLE index_fulltext
TRUNCATE TABLE index_grlist
TRUNCATE TABLE index_phash
TRUNCATE TABLE index_rel
TRUNCATE TABLE index_section
TRUNCATE TABLE index_stat_search
TRUNCATE TABLE index_stat_word
TRUNCATE TABLE index_words

TRUNCATE TABLE cache_pages
TRUNCATE TABLE cache_hash
TRUNCATE TABLE cache_imagesizes
TRUNCATE TABLE cache_pagesection
TRUNCATE TABLE cache_treelist
TRUNCATE TABLE cache_typo3temp_log
TRUNCATE TABLE cache_extensions

TRUNCATE TABLE tx_realurl_errorlog

TRUNCATE TABLE be_sessions
TRUNCATE TABLE fe_sessions
TRUNCATE TABLE fe_session_data[/PHP]

</pre>

== PHP Updates ==
=== PHP 5.5 2017 - Kurzanleitung ===
Kurzanleitung Update auf PHP 5.5 für TYPO3 4.5.x
<pre>
Wichtig
htaccess aktualisieren
Source aktualisieren
Umstellung utf8
- DB Export
- Textmate in utf-8 speichern
- Ersetzen von CHARSET=latin1 durch CHARSET=utf8
- Ersetzen der COLLATE
</pre>

localconf.php
=== PHP 5.6 2018 für TYPO 3 4.5 / 6.0===
Hinweis: 6.2 sollte laufen. Ältere Versionen sind ohnehin nicht mehr sicher.

Quelle:
http://www.typo3forum.net/discussion/79348/geloest-toolbaritem-shortcuts-must-implement-interface-backend-toolbaritem
https://www.typo3.net/forum/thematik/zeige/thema/123471/
Eine Suche im Netz ergab, dass T3 in der von mir verwendeten Version nicht mit PHP 5.6 kompatibel ist.

Unter diesem Link habe ich aber gefunden, wie man - bis zu einem Upgrade auf wenigstens 6.2 - das Backend wieder zum Laufen bekommt. Dazu müsste in folgenden Dateien über die Shell der Aufruf "&$backendReference" durch "$backendReference" ersetzt werden:

www/cms/typo3/classes/class.clearcachemenu.php:55:
www/cms/typo3/classes/class.livesearch.php:51:
www/cms/typo3/classes/class.shortcutmenu.php:79:
www/cms/typo3/interfaces/interface.backend_toolbaritem.php:43:
www/cms/typo3/sysext/opendocs/class.tx_opendocs.php:61:
www/cms/typo3/sysext/sys_action/toolbarmenu/class.tx_sysaction_toolbarmenu.php:53:
www/cms/typo3/sysext/sys_action/toolbarmenu/class.tx_sysaction_toolbarmenu.php:63:
www/cms/typo3/sysext/workspaces/Classes/BackendUserInterface/WorkspaceSelectorToolbarItem.php:59:

und zusätzlich noch

www/cms/typo3/classes/class.backendsearchmenu.php:52:
www/cms/typo3/classes/class.workspaceselector.php:57:
www/cms/typo3/sysext/workspaces/Classes/ExtDirect/WorkspaceSelectorToolbarItem.php:59

== Probleme lösen Version 7 ==
=== Update auf neuere Datenbanken Fehler: character set utf8 is not used for this connection ===
'''Potentielle Probleme:'''
* TYPO3 erwartet utf8 (genauer gesagt utf8mb3)
* TYPO3 7.6 geht standardmäßig von utf8_general_ci aus. Eine neuere Datenbank verwendet aber utf8mb3_general_ci – das ist funktional fast identisch mit dem alten utf8, aber durch neuere MySQL-Versionen expliziter gemacht. Trotzdem nicht 100 % dieselbe Bezeichnung → TYPO3 könnte das als Konflikt interpretieren.
* Verbindung läuft auf utf8mb4_unicode_ci Das ist ein 4-Byte-Zeichensatz, der nicht 100% kompatibel mit utf8mb3 ist. → Bei Sortierungen oder LIKE-Abfragen könnte TYPO3 falsche Ergebnisse bekommen (z. B. bei Umlauten, Emojis, Sonderzeichen). Ist aber i.d.R. nicht die Ursache für einen Datenbankfehler.
* Server-Default ist latin1_swedish_ci Dieser Zeichensatz ist alt und wird häufig von MySQL als Fallback verwendet. Gefährlich: Wenn irgendwo keine Zeichensatzangabe erfolgt (z. B. beim Import oder bei neuen Tabellen), wird automatisch latin1 genommen – und das zerstört Umlaute.

== Update auf 7 ==
https://jweiland.net/video-anleitungen/typo3/typo3-projekte-verwalten/upgrade-typo3-62-auf-7.html
[[TYPO3 Update - 6 auf 7]]
https://jweiland.net/video-anleitungen/typo3/typo3-projekte-verwalten/typo3-7-lts-migration-von-css-styled-content-nach-fluid-styled-content.html
* css_styled_content wird durch fluid_styled_content ersetzt
* FSC bringt eigene CSS-Klassen für das Frontend mit. Anpassungen im CSS einer Website sind notwendig.
* Die Funktion "Rahmen und Einrückungen (section_frames)" gibt es nicht mehr. Hier muss bei Bedarf auf das "Layout"-Feld ausgewichen werden.
* Überschriften lassen sich nicht mehr direkt zentrieren oder rechts ausrichten.
* Die Bildeffekte (Drehung, Graustufen etc.) gibt es auch nicht mehr.

=== Fluid Styled Content ersetzt CSS Styled Content ===
[[TYPO3 - fluid_styled_content]]

=== htaccess für all-inkl TYPO3 v7===
So machts der Auto Installer:
<pre>
php_value always_populate_raw_post_data -1
php_value memory_limit 256M
php_value max_execution_time 240
<FilesMatch "\.(php.*|phtml)\.">
RewriteEngine on
RewriteRule .* - [R=403,L]
</FilesMatch>
#####
#
# Example .htaccess file for TYPO3 CMS - for use with Apache Webserver
#
# This file includes settings for the following configuration options:
#
# - Compression
# - Caching
# - MIME types
# - Cross Origin requests
# - Rewriting and Access
# - Miscellaneous
# - PHP optimisation
#
# If you want to use it, you have to copy it to the root folder of your TYPO3 installation (if its
# not there already) and rename it to '.htaccess'. To make .htaccess files work, you might need to
# adjust the 'AllowOverride' directive in your Apache configuration file.
#
# IMPORTANT: You may need to change this file depending on your TYPO3 installation!
# Consider adding this file's content to your webserver's configuration directly for speed improvement
#
# Lots of the options are taken from https://github.com/h5bp/html5-boilerplate/blob/master/dist/.htaccess
#
####

### Begin: Compression ###

# Compressing resource files will save bandwidth and so improve loading speed especially for users
# with slower internet connections. TYPO3 can compress the .js and .css files for you.
# *) Uncomment the following lines and
# *) Set $GLOBALS['TYPO3_CONF_VARS']['BE']['compressionLevel'] = 9 for the Backend
# *) Set $GLOBALS['TYPO3_CONF_VARS']['FE']['compressionLevel'] = 9 together with the TypoScript properties
# config.compressJs and config.compressCss for GZIP compression of Frontend JS and CSS files.

#<FilesMatch "\.js\.gzip$">
# AddType "text/javascript" .gzip
#</FilesMatch>
#<FilesMatch "\.css\.gzip$">
# AddType "text/css" .gzip
#</FilesMatch>
#AddEncoding gzip .gzip

<IfModule mod_deflate.c>
# Force compression for mangled `Accept-Encoding` request headers
<IfModule mod_setenvif.c>
<IfModule mod_headers.c>
SetEnvIfNoCase ^(Accept-EncodXng|X-cept-Encoding|X{15}|~{15}|-{15})$ ^((gzip|deflate)\s*,?\s*)+|[X~-]{4,13}$ HAVE_Accept-Encoding
RequestHeader append Accept-Encoding "gzip,deflate" env=HAVE_Accept-Encoding
</IfModule>
</IfModule>

# Compress all output labeled with one of the following media types.
#
# (!) For Apache versions below version 2.3.7 you don't need to
# enable `mod_filter` and can remove the `<IfModule mod_filter.c>`
# and `</IfModule>` lines as `AddOutputFilterByType` is still in
# the core directives.
#
# https://httpd.apache.org/docs/current/mod/mod_filter.html#addoutputfilterbytype

<IfModule mod_filter.c>
AddOutputFilterByType DEFLATE application/atom+xml \
application/javascript \
application/json \
application/ld+json \
application/manifest+json \
application/rdf+xml \
application/rss+xml \
application/schema+json \
application/vnd.geo+json \
application/vnd.ms-fontobject \
application/x-font-ttf \
application/x-javascript \
application/x-web-app-manifest+json \
application/xhtml+xml \
application/xml \
font/eot \
font/opentype \
image/bmp \
image/svg+xml \
image/vnd.microsoft.icon \
image/x-icon \
text/cache-manifest \
text/css \
text/html \
text/javascript \
text/plain \
text/vcard \
text/vnd.rim.location.xloc \
text/vtt \
text/x-component \
text/x-cross-domain-policy \
text/xml
</IfModule>

<IfModule mod_mime.c>
AddEncoding gzip svgz
</IfModule>
</IfModule>

### End: Compression ###

### Begin: Browser caching of resource files ###

# This affects Frontend and Backend and increases performance.
<IfModule mod_expires.c>

ExpiresActive on
ExpiresDefault "access plus 1 month"

ExpiresByType text/css "access plus 1 year"

ExpiresByType application/json "access plus 0 seconds"
ExpiresByType application/ld+json "access plus 0 seconds"
ExpiresByType application/schema+json "access plus 0 seconds"
ExpiresByType application/vnd.geo+json "access plus 0 seconds"
ExpiresByType application/xml "access plus 0 seconds"
ExpiresByType text/xml "access plus 0 seconds"

ExpiresByType image/vnd.microsoft.icon "access plus 1 week"
ExpiresByType image/x-icon "access plus 1 week"

ExpiresByType text/x-component "access plus 1 month"

ExpiresByType text/html "access plus 0 seconds"

ExpiresByType application/javascript "access plus 1 year"
ExpiresByType application/x-javascript "access plus 1 year"
ExpiresByType text/javascript "access plus 1 year"

ExpiresByType application/manifest+json "access plus 1 week"
ExpiresByType application/x-web-app-manifest+json "access plus 0 seconds"
ExpiresByType text/cache-manifest "access plus 0 seconds"

ExpiresByType audio/ogg "access plus 1 month"
ExpiresByType image/bmp "access plus 1 month"
ExpiresByType image/gif "access plus 1 month"
ExpiresByType image/jpeg "access plus 1 month"
ExpiresByType image/png "access plus 1 month"
ExpiresByType image/svg+xml "access plus 1 month"
ExpiresByType image/webp "access plus 1 month"
ExpiresByType video/mp4 "access plus 1 month"
ExpiresByType video/ogg "access plus 1 month"
ExpiresByType video/webm "access plus 1 month"

ExpiresByType application/atom+xml "access plus 1 hour"
ExpiresByType application/rdf+xml "access plus 1 hour"
ExpiresByType application/rss+xml "access plus 1 hour"

ExpiresByType application/vnd.ms-fontobject "access plus 1 month"
ExpiresByType font/eot "access plus 1 month"
ExpiresByType font/opentype "access plus 1 month"
ExpiresByType application/x-font-ttf "access plus 1 month"
ExpiresByType application/font-woff "access plus 1 month"
ExpiresByType application/x-font-woff "access plus 1 month"
ExpiresByType font/woff "access plus 1 month"
ExpiresByType application/font-woff2 "access plus 1 month"

ExpiresByType text/x-cross-domain-policy "access plus 1 week"

</IfModule>

### End: Browser caching of resource files ###

### Begin: MIME types ###

# Proper MIME types for all files
<IfModule mod_mime.c>

# Data interchange
AddType application/atom+xml atom
AddType application/json json map topojson
AddType application/ld+json jsonld
AddType application/rss+xml rss
AddType application/vnd.geo+json geojson
AddType application/xml rdf xml

# JavaScript
AddType application/javascript js

# Manifest files
AddType application/manifest+json webmanifest
AddType application/x-web-app-manifest+json webapp
AddType text/cache-manifest appcache

# Media files

AddType audio/mp4 f4a f4b m4a
AddType audio/ogg oga ogg opus
AddType image/bmp bmp
AddType image/svg+xml svg svgz
AddType image/webp webp
AddType video/mp4 f4v f4p m4v mp4
AddType video/ogg ogv
AddType video/webm webm
AddType video/x-flv flv
AddType image/x-icon cur ico

# Web fonts
AddType application/font-woff woff
AddType application/font-woff2 woff2
AddType application/vnd.ms-fontobject eot
AddType application/x-font-ttf ttc ttf
AddType font/opentype otf

# Other
AddType application/octet-stream safariextz
AddType application/x-bb-appworld bbaw
AddType application/x-chrome-extension crx
AddType application/x-opera-extension oex
AddType application/x-xpinstall xpi
AddType text/vcard vcard vcf
AddType text/vnd.rim.location.xloc xloc
AddType text/vtt vtt
AddType text/x-component htc

</IfModule>

# UTF-8 encoding
AddDefaultCharset utf-8
<IfModule mod_mime.c>
AddCharset utf-8 .atom .css .js .json .manifest .rdf .rss .vtt .webapp .webmanifest .xml
</IfModule>

### End: MIME types ###

### Begin: Cross Origin ###

# Send the CORS header for images when browsers request it.
<IfModule mod_setenvif.c>
<IfModule mod_headers.c>
<FilesMatch "\.(bmp|cur|gif|ico|jpe?g|png|svgz?|webp)$">
SetEnvIf Origin ":" IS_CORS
Header set Access-Control-Allow-Origin "*" env=IS_CORS
</FilesMatch>
</IfModule>
</IfModule>

# Allow cross-origin access to web fonts.
<IfModule mod_headers.c>
<FilesMatch "\.(eot|otf|tt[cf]|woff2?)$">
Header set Access-Control-Allow-Origin "*"
</FilesMatch>
</IfModule>

### End: Cross Origin ###

### Begin: Rewriting and Access ###

# You need rewriting, if you use a URL-Rewriting extension (RealURL, CoolUri).

<IfModule mod_rewrite.c>

# Enable URL rewriting
RewriteEngine On

# Store the current location in an environment variable CWD to use
# mod_rewrite in .htaccess files without knowing the RewriteBase
RewriteCond $0#%{REQUEST_URI} ([^#]*)#(.*)\1$
RewriteRule ^.*$ - [E=CWD:%2]

# Rules to set ApplicationContext based on hostname
#RewriteCond %{HTTP_HOST} ^dev\.example\.com$
#RewriteRule .? - [E=TYPO3_CONTEXT:Development]
#RewriteCond %{HTTP_HOST} ^staging\.example\.com$
#RewriteRule .? - [E=TYPO3_CONTEXT:Production/Staging]
#RewriteCond %{HTTP_HOST} ^www\.example\.com$
#RewriteRule .? - [E=TYPO3_CONTEXT:Production]

# Rule for versioned static files, configured through:
# - $GLOBALS['TYPO3_CONF_VARS']['BE']['versionNumberInFilename']
# - $GLOBALS['TYPO3_CONF_VARS']['FE']['versionNumberInFilename']
# IMPORTANT: This rule has to be the very first RewriteCond in order to work!
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^(.+)\.(\d+)\.(php|js|css|png|jpg|gif|gzip)$ %{ENV:CWD}$1.$3 [L]

# Access block for folders
RewriteRule _(?:recycler|temp)_/ - [F]
RewriteRule fileadmin/templates/.*\.(?:txt|ts)$ - [F]
RewriteRule ^(?:vendor|typo3_src|typo3temp/logs) - [F]
RewriteRule (?:typo3conf/ext|typo3/sysext|typo3/ext)/[^/]+/(?:Configuration|Resources/Private|Tests?|Documentation|docs?)/ - [F]

# Block access to all hidden files and directories with the exception of
# the visible content from within the `/.well-known/` hidden directory (RFC 5785).
RewriteCond %{REQUEST_URI} "!(^|/)\.well-known/([^./]+./?)+$" [NC]
RewriteCond %{SCRIPT_FILENAME} -d [OR]
RewriteCond %{SCRIPT_FILENAME} -f
RewriteRule (?:^|/)\. - [F]

# Stop rewrite processing, if we are in the typo3/ directory or any other known directory
# NOTE: Add your additional local storages here
RewriteRule ^(?:typo3/|fileadmin/|typo3conf/|typo3temp/|uploads/|favicon\.ico) - [L]

# If the file/symlink/directory does not exist => Redirect to index.php.
# For httpd.conf, you need to prefix each '%{REQUEST_FILENAME}' with '%{DOCUMENT_ROOT}'.
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME} !-l
RewriteRule ^.*$ %{ENV:CWD}index.php [QSA,L]

</IfModule>

# Access block for files
<FilesMatch "(?i:^\.|^#.*#|^(?:ChangeLog|ToDo|Readme|License)(?:\.md|\.txt)?|^composer\.(?:json|lock)|^ext_conf_template\.txt|^ext_typoscript_constants\.txt|^ext_typoscript_setup\.txt|flexform[^.]*\.xml|locallang[^.]*\.(?:xml|xlf)|\.(?:bak|co?nf|cfg|ya?ml|ts|dist|fla|in[ci]|log|sh|sql(?:\..*)?|sw[op]|git.*)|.*(?:~|rc))$">
# Apache < 2.3
<IfModule !mod_authz_core.c>
Order allow,deny
Deny from all
Satisfy All
</IfModule>

# Apache ≥ 2.3
<IfModule mod_authz_core.c>
Require all denied
</IfModule>
</FilesMatch>

# Block access to vcs directories
<IfModule mod_alias.c>
RedirectMatch 404 /\.(?:git|svn|hg)/
</IfModule>

### End: Rewriting and Access ###

### Begin: Miscellaneous ###

# 404 error prevention for non-existing redirected folders
Options -MultiViews

# Make sure that directory listings are disabled.
<IfModule mod_autoindex.c>
Options -Indexes
</IfModule>

<IfModule mod_headers.c>
# Force IE to render pages in the highest available mode
Header set X-UA-Compatible "IE=edge"
<FilesMatch "\.(appcache|crx|css|eot|gif|htc|ico|jpe?g|js|m4a|m4v|manifest|mp4|oex|oga|ogg|ogv|otf|pdf|png|safariextz|svgz?|ttf|vcf|webapp|webm|webp|woff2?|xml|xpi)$">
Header unset X-UA-Compatible
</FilesMatch>

# Reducing MIME type security risks
Header set X-Content-Type-Options "nosniff"
</IfModule>

# ETag removal
<IfModule mod_headers.c>
Header unset ETag
</IfModule>
FileETag None

### End: Miscellaneous ###

# Add your own rules here.

</pre>

== Update auf 6.2 ==
=== Probleme mit dem index ===
https://forge.typo3.org/issues/61154

'''Fehlermeldung''' "Migrate all file links of RTE-enabled fields to FAL" fails with "Reference index was probably out of date."

Description

Meanwhile I did upgrades from TYPO3 4.7 to 6.2 for three different instances and every time I ran into this problem.
Reason are links in content elements of hidden or (from database point of view: logical) deleted pages where the target (usually the file in fileadmin) does not exist anymore.

cli_dispatch.phpsh lowlevel_refindex -c

does not detect these broken links. So this is a deadlock during migration.

I found this workaround which requires using a SQL client for the mysql database:
1) '''check''' if the result of this query matches the list of "Reference index was probably out of date" elements

select * from sys_refindex where softref_key = 'typolink_tag' AND ref_table = '_FILE';

2) If so you can '''update''' these records:

update sys_refindex set softref_key = 'typolink' where softref_key = 'typolink_tag' AND ref_table = '_FILE';

== Update 4.5 , 4.7 ==
=== Umlautprobleme ===
evtl. auch mal bei dbinit
<pre>
SET character_set_client = utf8;
SET character_set_results = utf8;
SET character_set_connection = utf8;
</pre>

Manchmal auch bei Darstellungsproblemen oder weißer Seite

Install-Tool nach dem Parameter "
systemLocale -> de_DE.utf8
'''Bis TYPO3 4.6''': im Install-Tool den Parameter
forceCharset -> utf-8
'''Ab TYPO3 4.7''': im '''Typoscript-Setup'''
config.renderCharset = utf-8
Im '''Install-Tool''' bei "
setDBinit -> SET NAMES utf8;
eintragen (ist ab TYPO3 4.7 bereits als Standard eingetragen).

Nun den kompletten Cache leeren. Jetzt sollten die Umlaute korrekt dargestellt werden.
</pre>
Falls Sie per GIFBUILDER Text in Bilder einbauen, versuchen Sie folgendes:
<pre>
Im Install-Tool beim Parameter "t3lib_cs_convMethod" den Wert "mbstring" eintragen.
Im Install-Tool beim Parameter "t3lib_cs_utils" ebenfalls " mbstring" eintragen.
</pre>
Falls Sie Templavoila verwenden, müssen Sie darauf achten, dass Ihr HTML-Editor die Datei UTF-8-kodiert speichert. In den meisten Editoren können Sie das in den Einstellungen anpassen.

Wenn immer noch Darstellungsprobleme auftreten, kann unter Umständen eine Konvertierung der Datenbank nötig sein.

== Update Infos 4.5 ==
* Weitere Tools werden separat installiert
* utf-8 für Datenbankverbindung wird vorausgesetzt (siehe auch Typo3 auf utf-8 umstellen)
** Install-Tool $TYPO3_CONF_VARS['SYS']['setDBinit'] und $TYPO3_CONF_VARS['BE']['forceCharset'] default haben sich verändert.

* Zugriff auf veraltete php-Funktionen werden geloggt. Vorsichtig Log kann groß werden
* Extbase und Fluid

== Update Infos 4.3 ==
* simulate_static_docs muss separat installiert werden
=== Update Wizard Info ===
'''CSS Styled Content: Default targets for non-frame pages'''

The default page target is empty (so no target is generated). If you use frames, you have to set target to "page" in Constants.

'''CSS Styled Content: htmlspecialchars in menu content elements'''

Page titles will get htmlspecialchar'ed when rendered in "Sitemap/menu" content elements, to avoid generating invalid XHTML.

'''htmlArea RTE: Using CSS classes for indentation and alignment'''

* Indentation is produced by a CSS class instead of the blockquote element.
You will need to specify in Page TSConfig the class to be used for indentation using property buttons.indent.useClass (default is "indent"). You will need to define this class in your stylesheets and ensure that it is allowed by the RTE transformation (RTE.default.proc). Alternatively, you may continue using the blockquote element by setting property buttons.indent.useBlockquote. You may also want to add the new blockquote button to the RTE toolbar.

* Text alignment is produced by CSS classes instead of deprecated align attribute.
You will need to specify in Page TSConfig the class to be used for each text alignment button using property buttons.[left, center, right or justifyfull].useClass (defaults are "align-left", "align-center", "align-right", "align-justify"). You will need to define these classes in your stylesheets, and ensure that they are allowed by the RTE transformation (RTE.default.proc). Alternatively, you may continue using deprecated align attribute by setting property buttons.[left, center, right or justifyfull].useAlignAttribute.

== Update alter Typo3 Installationen (<V.3.8)==
Aus der Mailing Liste Östereich:
- der Core ist relativ easy (fast) immer zu upgraden (muesst' eigentlich von
v3.3 auch gehen ;-) )
- Achte immer auf installierte Extensions
* wenn etwas nicht geht, mal soweit wie moeglich alle Extensions wegschalten (nicht loeschen!).
* dann zuschalten; wenns dann hakt, dann sieht man gleich welche ext "boese" ist.
* dann diese ext updaten, wenns keine updates gibt, mal danach googlen.
* wenns dann net geht, debuggen..

Weitere Probleme:

Alte TS Templates arbeiten noch mit CSet und Content als default Template. Nach umstellen auf css-styled-content muß evt. einiges angepasst werden:
== Update auf 4.2 ==
<pre>
Backup erstellen (sollte selbstverständlich sein)!
Notieren welche Extensions "Global" installiert wurden, da diese später wieder erneut installiert werden müssen
Resource herunterladen:
wget kent.dl.sourceforge.net/sourceforge/typo3/typo3_src-4.2.8.tar.gz
Source-Paket entpacken:
tar -xzf typo3_src-4.2.8.tar.gz
Im Verzeichnis typo3conf müssen Sie eine Datei mit dem Namen "ENALBE_INSTALL_TOOL" erstellen bzw. uploaden (ich mache das immer mit vi ENABLE_INSTALL_TOOL )
eventuell die Rechte und die Gruppe ändern
eventuell basedir_restriction anpassen (für Plesk siehe hier)
typo3_src Symlink löschen:
rm typo3_src
neuen Symlink anlegen:
ln -s ../../typo3_src-4.2.8/ typo3_src
(den richtigen Pfad zum Source-Verzeichnis eventuell anpassen)
index.php löschen und neu erstellen:
rm index.php
ln -s typo3_src/index.php index.php
alte Verzeichnisse löschen (media, tslib)
alte Dateien löschen (showpic.php)
fehlende Verzeichnisse erstellen:
typo3conf/l10n, typo3temp/temp, typo3temp/GB, typo3temp/pics, typo3temp/llxml/, typo3temp/cs/ (sofern diese nicht schon vorhanden sind)
Installtool aufrufen und "Basic Configuration" überprüfen; hier sollte alles im grünen Bereich sein. Wenn nicht entsprechende Probleme beheben.
"Update Wizard" ausführen
Im "Database Analyser" auf "Update required tables" auf "Compare" klicken und bestätigen
Ins Backend einloggen und alle "Global" installierten Extensions nachinstallieren
Im Ext Manager unter Settings "Enable unsupported extensions" aktivieren, da zur Zeit noch nicht alle Exentensions überprüft wurden.
Im Ext Manager unter "Import extensions" auf "Retrieve/Update" klicken, um die aktuelle Liste der Extensions herunterzuladen
(Sollte es dabei zu Fehlermeldungen kommen, muss u.U. auf curl umgestellt werden) Leider ist das neue TER 2.0 extrem speicherhungrig, so dass u.U. die Speicherbeschränkung von PHP nicht ausreicht. Wenn möglich sollten Sie also zuvor den verfügbaren Speicher von PHP auf min. 45MB(!) hochsetzen. Sollten Sie dazu keine Rechte haben oder soviel Speicher nicht zur Verfügung stellen wollen, können Sie sich dadurch behelfen, dass Sie die benötigten Extensions als .t3x-Dateien herunterladen und "von Hand" installieren.
Im Ext Manager die Sprache updaten
Eventuell veraltete local-installierte Extensions erneuern (z.B. TemplaVoila, static_info_tables u.ä.)
Nicht mehr benötigte "Local"-installierte Extensions entfernen, wie z.B. csh_de, htmlarea (ist jetzt eine "System"-Extension und sollte daher local deinstalliert werden)
</pre>
== Update auf 4.1 ==
Unbedingt im Install Tool Compare ausführen und Tabellen aktualisieren. Sonst kann es Probleme mit verschiedenen Extensions geben (z.B. Login..)

== Probleme beim TYPO3 Update lösen ==
=== Weiße Seite ===
* Fehlermeldungen einschalten
=== The requested URL /typo3/alt_main.php was not found on this server.===
Symlink für index.php falsch
=== Nach dem Datenbank Compare fehlen Teile der TYPOScript Templates ===

'''Lösung'''

Von Version 4.2 auf 4.1 werden blob Felder zu Text Feldern umgewandelt. Dabei werden bei Umlauten die Inhalte abgeschnitten, wenn die Datenbank utf-8 arbeitet, TYPO3 aber die Daten in latin abgelegt hat.

Beim Compare muß man dann die blob konvertierungen weglassen (vor allem bei den Templates - in der Regel gibt es da Kommentare mit Umlauten) und leicht abgewandelt selbst durchführen:

ALTER TABLE sys_template CHANGE config config TEXT CHARACTER SET latin1;

Typo3 läßt hier die Angabe welcher Zeichensatz drin ist weg.

Die wichtigsten Statements (Stand Typo3 4.5):

<pre>
ALTER TABLE sys_template CHANGE constants constants text CHARACTER SET latin1;
ALTER TABLE sys_template CHANGE config config text CHARACTER SET latin1;
ALTER TABLE tt_content CHANGE image image text CHARACTER SET latin1;
ALTER TABLE tt_content CHANGE media media text CHARACTER SET latin1;
ALTER TABLE tt_content CHANGE pages pages tinytext CHARACTER SET latin1;
ALTER TABLE tt_content CHANGE multimedia multimedia tinytext CHARACTER SET latin1;
ALTER TABLE pages CHANGE media media text CHARACTER SET latin1;
</pre>

Link: http://dev.mysql.com/doc/refman/5.1/en/alter-table.html (Zugriff: 10/2012)

== Release Notes Version 4.1 ==
Die wichtigsten Neuerungen
* IRRE (Inline Relational Record Editing)
* AJAX Page and File Tree
* Clean-up functions (command line scripts)(Über Extension lowlevel)
* Improved Extension Manager (less memory, stored extension list)
* UTF-8 for filenames
* Backend "Who is online"
* Frontend "Stay logged in" (Konfiguration mit new login box)
* MySQL InnoDB (Wird automatisch bei Neuinstallation zur Verfügung gestellt, wenn es in mySQL aktiviert ist)
* Speed up Backend with .htaccess http://typo3.org/development/articles/release-notes-41/page/4/)

=== Manuelles ändern der Tabellen auf InnoDB ===
Hinweis persönlich rate ich von INNODB und TYPO3 ab, besser ISAM nehmen
<pre>
alter table cache_hash ENGINE = INNODB;
alter table cache_imagesizes ENGINE = INNODB;
alter table cache_md5params ENGINE = INNODB;
alter table cache_pages ENGINE = INNODB;
alter table cache_pagesection ENGINE = INNODB;
alter table cache_typo3temp_log ENGINE = INNODB;
alter table fe_sessions ENGINE = INNODB;
alter table fe_session_data ENGINE = INNODB;
alter table index_fulltext ENGINE = INNODB;
alter table index_grlist ENGINE = INNODB;
alter table index_phash ENGINE = INNODB;
alter table index_rel ENGINE = INNODB;
alter table index_section ENGINE = INNODB;
alter table index_stat_search ENGINE = INNODB;
alter table index_stat_word ENGINE = INNODB;
alter table index_words ENGINE = INNODB;
alter table sys_log ENGINE = INNODB;
</pre>

== Generelle Informationen zum Update unter Linux ==
Quelle: typo3.net Mai 2006

Typo3 ist normalerweise sehr einfach upzudaten - allerdings müssen ein paar Dinge beachtet werden, um updatefähig zu bleiben:

* Es dürfen keine Änderungen an dem Typo3-Sourcecode gemacht worden sein. Falls dieses doch gemacht wurde, müssen natürlich diese Änderungen erst in die neue Version eingearbeitet werden.
* Installierte Extensions sollten möglichst immer LOCAL installiert worden sein. So bleiben diese nach dem Tausch des Typo3-Sourcecodes unberührt und funktionieren nach dem Update (meist) wie gewohnt. Es gibt nur selten den Fall, daß eine Typo3-Version eine Funktion nicht mehr verwendet, die es in der alten Version noch gab.
* Wenn sie HTML-Templates von GLOBAL installierten Erweiterungen direkt im Extensionordner modifiziert haben sollten, müssen diese erst z.B. in den fileadmin kopiert werden. Dann können Sie den Pfad zu dieser Datei im TypoScript anpassen.

Den Pfad finden Sie überigens mithilfe des TypoScript-Object-Browsers schnell. Meist ist er an der Stelle plugin.extensionname.templateFile zu finden.

[[Bild:T3_wichtigeVerzeichnisse.gif]]

Einige der wichtigsten Verzeichnisse

'''Das Update für mittwaldmedien Kunden'''
Für unsere Kunden ist es nun besonders einfach, die vorhandene Installation auf die aktuelle Version zu bringen. Sie müssen sich nur auf der Webseite http://www.typo3server.com einloggen. Nach dem Login finden Sie ein Menü mit einem Link zu dem Typo3-Versionsmanager. Dort können Sie mit einem Klick Ihren Account auf die neue Version updaten.

'''ToDo Versionsmanager für Geo-bit'''

'''Manuelles Update'''

Für diejenigen, die dieses Update manuell machen wollen oder müssen, sind die folgenden Schrittenötig. Die Beispiele - vor allem die Pfade - müssen natürlich angepasst werden. Die Beispiele gehen davon aus, daß Sie eine Verzeichnisstruktur angelegt haben, die dem obigen Bild entspricht.

1. Machen Sie zuerst eine Datensicherung von dem Typo3-Sourcen und Ihrem html-Ordner! Die Datenbank können Sie nun über diesen Befehl sichern:

mysqldump -u benutzername -p -B --add-drop-table datenbank > typo3DBSicherung.sql

Notfalls könnte auch ein Dump mit phpMyAdmin erstellt werden.

2. Verbinden Sie sich mit Ihrem Server über SSH.

3. Wechseln Sie das Verzeichnis auf einer Ebene über dem Rootverzeichnis Ihres Webservers.
z.B.: cd /home/www/p1234/

4. Laden Sie sich die neuen Typo3-Sourcen auf ihren Linuxrechner. Die aktuellen Sourcen finden Sie unter: http://typo3.org/download/packages/.

Die benötigte Datei hat das Format typo3_src-3.x.x.tar.gz

'''Beispiel:'''

wget belnet.dl.sourceforge.net/sourceforge/typo3/typo3_src-3.7.0.tar.gz

5. Entpacken Sie die Datei mit dem Kommando:

'''Beispiel:'''

tar -xzvf typo3_src-3.x.x.tar.gz

6. Ändern Sie nun die Rechte so, wie der bisherige Typo3-Sourcecode-Ordner sie hatte.

'''Beispiel:'''

chown p1234.ftponly typo3_src-3.7.0 -R

7. Entfernen Sie den alten symbolischen Link mit:

rm typo3_src

8. Legen Sie nun einen neuen Link an mit:

ln -s typo3_src-3.x.x typo3_src

(Die Versionsnummer müssen Sie natürlich noch anpassen.)

9. Nun muss die Datenbank noch aktualisiert werden:

Gehen Sie hierzu in das Typo3-Installtool und klicken Sie auf den 2. Menüpunkt Database Analyser. Mit einem Klick auf Compare werden die zu ändernden oder zu ergänzenden Datenbankfelder angezeigt. Mit einem Klick auf "Write to database" wird die Datenbank an die neue Typo3-Version angepasst.

10. Loggen Sie sich nun als Admin im Backend an und löschen Sie alle Caches.

== Neu in Version 4 ==
* Conditions mit AND und OR (|| &&)

== Neu in 4.2 ==
Viele Usability Verbesserungen im Backend
== Update auf 4.2 ==
=== Extensions Updaten ===
* dam 1.0.11 ist nicht kompatibel Update auf min. 1.0.13
* date2cal auf >= 7.1.0
* Kickstarter 0.3.8 ist nicht kompatibel
* Developer tools gehen nicht mehr (wg. Frame oben)

=== Ablauf ===
* Backend Benutzer sperren (only Admins)
* Sicherung der Datenbank
* neue Source + Symlink
* Update Wizard
* Compare

=== Probleme ===
'''DAM Upload geht für Benutzer''' nicht mehr (Fehler Meta Daten können nicht geschrieben werden)
Beim neu indizieren geht dem dam der Media Ordner verloren. Er legt dann einen neuen an, in den er scheiben möchte. Die Benutzer sind abe noch auf den alten eingestellt. D.h. die Benutzergruppen m´üssen auf den neuen eingestellt werden.

Im Dam stehen im IE7 die Benutzerwerkzeuge nicht zur verfügung (löschen etc.) nur der Stift ist noch da.

Lösung: Das Problem ist das CSS für das Fenster. Es verdeckt die restlichen Symbole
Forum: 24.7.

Ich hatte das gleiche Problem bis vor 5 Minuten auch,
gelöst habe ich es so:
- Datei: class.tx_dam_listbase.php im Ordner DAM\lib\
Unter der Zeile 256 ('itemTD' => ' class="typo3-dblist-item"',)
ist in 3 Werten als Breite 1% angegeben. Das auskommentieren

- Datei: stylesheet.cdd in typo3_src\typo3\
table.typo3-dblist width: 98%; durch width: auto; ersetzen und in
table.typo3-dblist tr td {width: auto;} einsetzen,

damit hats bei mir im IE 7, Firefox, safari für Win und Opera alles richtig angezeigt :-)

Ich hoffe, geholrfen zu haben,
Schmoozer

Bug in Mount Points

== Datenbank über Root Shell sichern (mysql backup) ==

mysqldump -opt ...

Beispiele

Die häufigste Anwendung von mysqldump ist wahrscheinlich die '''Erstellung eines Backups einer vollständigen Datenbank''':

shell> mysqldump --opt db_name > backup-file.sql

oder mit User und Passwortangabe:
mysqldump -u meinDBUser -pGEHEIM db_name > backup.sql

--opt ist in neueren MySQL Versionen Standardmäßig an deshalb lassen wir es mal weg.

Die Speicherauszugsdatei können Sie wie folgt '''wieder einspielen'''.

shell> mysql db_name < backup-file.sql

Oder aber so:

shell> mysql -e "source /path-to-backup/backup-file.sql" db_name

mysqldump ist ferner sehr nützlich zum Ausfüllen von Datenbanken durch Kopieren von Daten von einem MySQL Server auf einen anderen:

shell> mysqldump --opt db_name | mysql --host=remote_host -C db_name

Sie können mit einem einzigen Befehl einen Speicherauszug mehrerer Datenbanken erstellen:

shell> mysqldump --databases db_name1 [db_name2 ...] > my_databases.sql

Um einen Speicherauszug aller Datenbanken zu erstellen, verwenden Sie die Option --all-databases:

shell> mysqldump --all-databases > all_databases.sql

Bei InnoDB-Tabellen bietet mysqldump die Möglichkeit, eine Online-Sicherung zu erstellen:

shell> mysqldump --all-databases --single-transaction > all_databases.sql

Diese Datensicherung muss vor Beginn des Speicherauszugsvorgangs lediglich (mit FLUSH TABLES WITH READ LOCK) eine globale Lesesperre für alle Tabellen erwirken. Sobald diese Sperre aktiv ist, werden die Koordinaten des Binärlogs ausgelesen, und die Sperre wird aufgehoben. Wenn beim Absetzen der FLUSH-Anweisung gerade eine umfangreiche Änderungsanweisung ausgeführt wird, dann – und nur dann! – kann der MySQL Server stehen bleiben, bis diese lange Anweisung ausgeführt ist; danach ist der Server sperrfrei. Wenn die vom MySQL Server empfangenen Änderungsanweisungen (in Bezug auf ihre Ausführungsdauer) kurz sind, sollte die anfängliche Sperrperiode auch bei vielen Änderungen nicht spürbar sein.

Bei der Point-in-Time-Wiederherstellung (die auch als „Roll-Forward“ bezeichnet wird, wenn Sie ein altes Backup wiederherstellen und die seitdem durchgeführten Änderungen neu aufspielen müssen) ist es häufig nützlich, das Binärlog zu rotieren (siehe Abschnitt 5.12.3, „Die binäre Update-Logdatei“) oder zumindest die Binärlogkoordinaten zu kennen, denen der Speicherauszug entspricht:

shell> mysqldump --all-databases --master-data=2 > all_databases.sql

Oder:

shell> mysqldump --all-databases --flush-logs --master-data=2
> all_databases.sql

== Mass Update Script ==

Yesterday some updates came out for TYPO3. These updates fixed certain issues and we needed to update all of our excellent shared hosting environments.

We already have a script (which is more elaborate now) that checks all our TYPO3 installations and sends the sysadmins a nice report about its findings. We use part of that report (list of paths to Document Roots) to feed the updater script.

The TYPO3 update requires you to do the followi

* update encryption key
* clear configuration cache
* clear page cache

We do not want to go into 200+ TYPO3 backends and do those tasks manually. We are lazy and we will write a script to automagically do the boring tasks for us.

This script is not perfect but it works well on Debian systems. You can modify it to fit your needs. It was just a quick hack to ease the upgrade pain. Take care to switch the symlink part for upgrade runs of different versions of TYPO3.

I am not responsible for any damage to your system that may occur to misuse of this script. Make sure you understand it before you run it. Run it with a single URI before attempting a whole ist of URI's.

Ein Massen Update Script von:

http://typofree.org/article/archive/2009/january/title/typo3-mass-upgrade-script/
Zugriff am 12.3.2009

http://typofree.org/article/archive/2009/january/title/typo3-mass-upgrade-script/

TYPO3 mass update script

1.
#!/bin/sh
2.
binDir=/usr/bin/
3.
sleep=2
4.

5.
pageCacheTables=(
6.
cache_pages
7.
cache_pagesection
8.
)
9.

10.
sites=(
11.
/var/www/sites/live/www.somedomain.tld
12.
/var/www/sites/live/www.someotherdomain.tld
13.
/var/www/sites/live/www.yetsomeotherdomain.tld
14.
)
15.

16.
len=${#sites[*]}
17.
pageCacheTablesLength=${#pageCacheTables[*]}
18.
i=0
19.
while [ $i -lt $len ]; do
20.
echo updating: ${sites[$i]}
21.
cd ${sites[$i]}
22.
rm typo3_src
23.
ln -s ../../sources/typo3_src-4.2.5 typo3_src
24.

25.
echo generating new key
26.
k=0
27.
key=''
28.
while [ $k -lt 96 ]; do
29.
key=$key$(head -100 /dev/urandom | md5sum | cut -c1)
30.
let k++
31.
done
32.
echo key: $key
33.
sed -i "s/$\$TYPO3_CONF_VARS\['SYS']\['encryptionKey'] = $.*/\1'$key';/g" typo3conf/localconf.php
34.

35.
echo removing configuration cache
36.
rm -f typo3conf/temp_CACHED*
37.

38.
echo clearing page cache
39.
# For some insane reason some values are enclosed in double qotes
40.
database=$(grep "typo_db " typo3conf/localconf.php | tail -1 | sed "s/^[^']*'$[^']*$'.*/\1/" | grep '$typo_db =')
41.
if [ -z "$database" ] ; then
42.
database=$(grep "typo_db " typo3conf/localconf.php | tail -1 | sed "s/^[^']*'$[^']*$'.*/\1/")
43.
else
44.
database=$(grep "typo_db " typo3conf/localconf.php | tail -1 | sed "s/^[^\"]*\"$[^\"]*$\".*/\1/")
45.
fi
46.
username=$(grep "typo_db_username " typo3conf/localconf.php | tail -1 | sed "s/^[^']*'$[^']*$'.*/\1/" | grep '$typo_db_username =')
47.
if [ -z "$username" ] ; then
48.
username=$(grep "typo_db_username " typo3conf/localconf.php | tail -1 | sed "s/^[^']*'$[^']*$'.*/\1/")
49.
else
50.
username=$(grep "typo_db_username " typo3conf/localconf.php | tail -1 | sed "s/^[^\"]*\"$[^\"]*$\".*/\1/")
51.
fi
52.
password=$(grep "typo_db_password " typo3conf/localconf.php | tail -1 | sed "s/^[^']*'$[^']*$'.*/\1/" | grep '$typo_db_password =')
53.
if [ -z "$password" ] ; then
54.
password=$(grep "typo_db_password " typo3conf/localconf.php | tail -1 | sed "s/^[^']*'$[^']*$'.*/\1/")
55.
else
56.
password=$(grep "typo_db_password " typo3conf/localconf.php | tail -1 | sed "s/^[^\"]*\"$[^\"]*$\".*/\1/")
57.
fi
58.
j=0
59.
while [ $j -lt $pageCacheTablesLength ];
60.
do
61.
nice -n 19 ${binDir}mysql --batch -u$username -p"$password" -D$database -e "TRUNCATE ${pageCacheTables[$j]}"
62.
nice -n 19 ${binDir}mysql --batch -u$username -p"$password" -D$database -e "ALTER TABLE ${pageCacheTables[$j]} auto_increment=1"
63.
let j++
64.
done
65.

66.
echo "done! Sleeping $sleep seconds . . ."
67.
sleep $sleep
68.

69.
echo
70.
let i++
71.
done

Typo3 - Update

2025-04-15T11:29:47Z

109.193.152.88: /* Update auf 7 */

== Links ==
http://wiki.typo3.org/Upgrade

[[TYPO3 - Troubleshooting Version 8]]
[[TYPO3 - Änderungen Version 9]]
== Aufräumen vor dem Update ==
http://typo3blogger.de/turchen-2-tutorial-typo3-entrumpeln/

=== Files ===
* kb_cleanfiles.
* Modul unter „DB-Überprüfung“ -> „Database Relations“. Neben dem Listing „Dateien, die in keinem Eintrag verwendet werden (bitte löschen!):“, welches der inhaltlichen Ausgabe der Extension sehr ähnelt, wird hier auch angezeigt ob Dateien doppelt referenziert werden
* typo3temp über install tool
=== Datenbank ===
* kj_recycler für papierkorb Daten danach refefence Index updaten
* cache_ Tabellen leeren
* sys_histroy leeren

Zur Not alles löschbar...

<pre>
[PHP]TRUNCATE TABLE sys_log //e.g. alle älter als 14 Tage
TRUNCATE TABLE sys_history //e.g. alle änderungen älter als 30 Tage

TRUNCATE TABLE index_fulltext
TRUNCATE TABLE index_grlist
TRUNCATE TABLE index_phash
TRUNCATE TABLE index_rel
TRUNCATE TABLE index_section
TRUNCATE TABLE index_stat_search
TRUNCATE TABLE index_stat_word
TRUNCATE TABLE index_words

TRUNCATE TABLE cache_pages
TRUNCATE TABLE cache_hash
TRUNCATE TABLE cache_imagesizes
TRUNCATE TABLE cache_pagesection
TRUNCATE TABLE cache_treelist
TRUNCATE TABLE cache_typo3temp_log
TRUNCATE TABLE cache_extensions

TRUNCATE TABLE tx_realurl_errorlog

TRUNCATE TABLE be_sessions
TRUNCATE TABLE fe_sessions
TRUNCATE TABLE fe_session_data[/PHP]

</pre>

== PHP Updates ==
=== PHP 5.5 2017 - Kurzanleitung ===
Kurzanleitung Update auf PHP 5.5 für TYPO3 4.5.x
<pre>
Wichtig
htaccess aktualisieren
Source aktualisieren
Umstellung utf8
- DB Export
- Textmate in utf-8 speichern
- Ersetzen von CHARSET=latin1 durch CHARSET=utf8
- Ersetzen der COLLATE
</pre>

localconf.php
=== PHP 5.6 2018 für TYPO 3 4.5 / 6.0===
Hinweis: 6.2 sollte laufen. Ältere Versionen sind ohnehin nicht mehr sicher.

Quelle:
http://www.typo3forum.net/discussion/79348/geloest-toolbaritem-shortcuts-must-implement-interface-backend-toolbaritem
https://www.typo3.net/forum/thematik/zeige/thema/123471/
Eine Suche im Netz ergab, dass T3 in der von mir verwendeten Version nicht mit PHP 5.6 kompatibel ist.

Unter diesem Link habe ich aber gefunden, wie man - bis zu einem Upgrade auf wenigstens 6.2 - das Backend wieder zum Laufen bekommt. Dazu müsste in folgenden Dateien über die Shell der Aufruf "&$backendReference" durch "$backendReference" ersetzt werden:

www/cms/typo3/classes/class.clearcachemenu.php:55:
www/cms/typo3/classes/class.livesearch.php:51:
www/cms/typo3/classes/class.shortcutmenu.php:79:
www/cms/typo3/interfaces/interface.backend_toolbaritem.php:43:
www/cms/typo3/sysext/opendocs/class.tx_opendocs.php:61:
www/cms/typo3/sysext/sys_action/toolbarmenu/class.tx_sysaction_toolbarmenu.php:53:
www/cms/typo3/sysext/sys_action/toolbarmenu/class.tx_sysaction_toolbarmenu.php:63:
www/cms/typo3/sysext/workspaces/Classes/BackendUserInterface/WorkspaceSelectorToolbarItem.php:59:

und zusätzlich noch

www/cms/typo3/classes/class.backendsearchmenu.php:52:
www/cms/typo3/classes/class.workspaceselector.php:57:
www/cms/typo3/sysext/workspaces/Classes/ExtDirect/WorkspaceSelectorToolbarItem.php:59

== Update auf 7 ==
https://jweiland.net/video-anleitungen/typo3/typo3-projekte-verwalten/upgrade-typo3-62-auf-7.html
[[TYPO3 Update - 6 auf 7]]
https://jweiland.net/video-anleitungen/typo3/typo3-projekte-verwalten/typo3-7-lts-migration-von-css-styled-content-nach-fluid-styled-content.html
* css_styled_content wird durch fluid_styled_content ersetzt
* FSC bringt eigene CSS-Klassen für das Frontend mit. Anpassungen im CSS einer Website sind notwendig.
* Die Funktion "Rahmen und Einrückungen (section_frames)" gibt es nicht mehr. Hier muss bei Bedarf auf das "Layout"-Feld ausgewichen werden.
* Überschriften lassen sich nicht mehr direkt zentrieren oder rechts ausrichten.
* Die Bildeffekte (Drehung, Graustufen etc.) gibt es auch nicht mehr.

=== Fluid Styled Content ersetzt CSS Styled Content ===
[[TYPO3 - fluid_styled_content]]

=== htaccess für all-inkl TYPO3 v7===
So machts der Auto Installer:
<pre>
php_value always_populate_raw_post_data -1
php_value memory_limit 256M
php_value max_execution_time 240
<FilesMatch "\.(php.*|phtml)\.">
RewriteEngine on
RewriteRule .* - [R=403,L]
</FilesMatch>
#####
#
# Example .htaccess file for TYPO3 CMS - for use with Apache Webserver
#
# This file includes settings for the following configuration options:
#
# - Compression
# - Caching
# - MIME types
# - Cross Origin requests
# - Rewriting and Access
# - Miscellaneous
# - PHP optimisation
#
# If you want to use it, you have to copy it to the root folder of your TYPO3 installation (if its
# not there already) and rename it to '.htaccess'. To make .htaccess files work, you might need to
# adjust the 'AllowOverride' directive in your Apache configuration file.
#
# IMPORTANT: You may need to change this file depending on your TYPO3 installation!
# Consider adding this file's content to your webserver's configuration directly for speed improvement
#
# Lots of the options are taken from https://github.com/h5bp/html5-boilerplate/blob/master/dist/.htaccess
#
####

### Begin: Compression ###

# Compressing resource files will save bandwidth and so improve loading speed especially for users
# with slower internet connections. TYPO3 can compress the .js and .css files for you.
# *) Uncomment the following lines and
# *) Set $GLOBALS['TYPO3_CONF_VARS']['BE']['compressionLevel'] = 9 for the Backend
# *) Set $GLOBALS['TYPO3_CONF_VARS']['FE']['compressionLevel'] = 9 together with the TypoScript properties
# config.compressJs and config.compressCss for GZIP compression of Frontend JS and CSS files.

#<FilesMatch "\.js\.gzip$">
# AddType "text/javascript" .gzip
#</FilesMatch>
#<FilesMatch "\.css\.gzip$">
# AddType "text/css" .gzip
#</FilesMatch>
#AddEncoding gzip .gzip

<IfModule mod_deflate.c>
# Force compression for mangled `Accept-Encoding` request headers
<IfModule mod_setenvif.c>
<IfModule mod_headers.c>
SetEnvIfNoCase ^(Accept-EncodXng|X-cept-Encoding|X{15}|~{15}|-{15})$ ^((gzip|deflate)\s*,?\s*)+|[X~-]{4,13}$ HAVE_Accept-Encoding
RequestHeader append Accept-Encoding "gzip,deflate" env=HAVE_Accept-Encoding
</IfModule>
</IfModule>

# Compress all output labeled with one of the following media types.
#
# (!) For Apache versions below version 2.3.7 you don't need to
# enable `mod_filter` and can remove the `<IfModule mod_filter.c>`
# and `</IfModule>` lines as `AddOutputFilterByType` is still in
# the core directives.
#
# https://httpd.apache.org/docs/current/mod/mod_filter.html#addoutputfilterbytype

<IfModule mod_filter.c>
AddOutputFilterByType DEFLATE application/atom+xml \
application/javascript \
application/json \
application/ld+json \
application/manifest+json \
application/rdf+xml \
application/rss+xml \
application/schema+json \
application/vnd.geo+json \
application/vnd.ms-fontobject \
application/x-font-ttf \
application/x-javascript \
application/x-web-app-manifest+json \
application/xhtml+xml \
application/xml \
font/eot \
font/opentype \
image/bmp \
image/svg+xml \
image/vnd.microsoft.icon \
image/x-icon \
text/cache-manifest \
text/css \
text/html \
text/javascript \
text/plain \
text/vcard \
text/vnd.rim.location.xloc \
text/vtt \
text/x-component \
text/x-cross-domain-policy \
text/xml
</IfModule>

<IfModule mod_mime.c>
AddEncoding gzip svgz
</IfModule>
</IfModule>

### End: Compression ###

### Begin: Browser caching of resource files ###

# This affects Frontend and Backend and increases performance.
<IfModule mod_expires.c>

ExpiresActive on
ExpiresDefault "access plus 1 month"

ExpiresByType text/css "access plus 1 year"

ExpiresByType application/json "access plus 0 seconds"
ExpiresByType application/ld+json "access plus 0 seconds"
ExpiresByType application/schema+json "access plus 0 seconds"
ExpiresByType application/vnd.geo+json "access plus 0 seconds"
ExpiresByType application/xml "access plus 0 seconds"
ExpiresByType text/xml "access plus 0 seconds"

ExpiresByType image/vnd.microsoft.icon "access plus 1 week"
ExpiresByType image/x-icon "access plus 1 week"

ExpiresByType text/x-component "access plus 1 month"

ExpiresByType text/html "access plus 0 seconds"

ExpiresByType application/javascript "access plus 1 year"
ExpiresByType application/x-javascript "access plus 1 year"
ExpiresByType text/javascript "access plus 1 year"

ExpiresByType application/manifest+json "access plus 1 week"
ExpiresByType application/x-web-app-manifest+json "access plus 0 seconds"
ExpiresByType text/cache-manifest "access plus 0 seconds"

ExpiresByType audio/ogg "access plus 1 month"
ExpiresByType image/bmp "access plus 1 month"
ExpiresByType image/gif "access plus 1 month"
ExpiresByType image/jpeg "access plus 1 month"
ExpiresByType image/png "access plus 1 month"
ExpiresByType image/svg+xml "access plus 1 month"
ExpiresByType image/webp "access plus 1 month"
ExpiresByType video/mp4 "access plus 1 month"
ExpiresByType video/ogg "access plus 1 month"
ExpiresByType video/webm "access plus 1 month"

ExpiresByType application/atom+xml "access plus 1 hour"
ExpiresByType application/rdf+xml "access plus 1 hour"
ExpiresByType application/rss+xml "access plus 1 hour"

ExpiresByType application/vnd.ms-fontobject "access plus 1 month"
ExpiresByType font/eot "access plus 1 month"
ExpiresByType font/opentype "access plus 1 month"
ExpiresByType application/x-font-ttf "access plus 1 month"
ExpiresByType application/font-woff "access plus 1 month"
ExpiresByType application/x-font-woff "access plus 1 month"
ExpiresByType font/woff "access plus 1 month"
ExpiresByType application/font-woff2 "access plus 1 month"

ExpiresByType text/x-cross-domain-policy "access plus 1 week"

</IfModule>

### End: Browser caching of resource files ###

### Begin: MIME types ###

# Proper MIME types for all files
<IfModule mod_mime.c>

# Data interchange
AddType application/atom+xml atom
AddType application/json json map topojson
AddType application/ld+json jsonld
AddType application/rss+xml rss
AddType application/vnd.geo+json geojson
AddType application/xml rdf xml

# JavaScript
AddType application/javascript js

# Manifest files
AddType application/manifest+json webmanifest
AddType application/x-web-app-manifest+json webapp
AddType text/cache-manifest appcache

# Media files

AddType audio/mp4 f4a f4b m4a
AddType audio/ogg oga ogg opus
AddType image/bmp bmp
AddType image/svg+xml svg svgz
AddType image/webp webp
AddType video/mp4 f4v f4p m4v mp4
AddType video/ogg ogv
AddType video/webm webm
AddType video/x-flv flv
AddType image/x-icon cur ico

# Web fonts
AddType application/font-woff woff
AddType application/font-woff2 woff2
AddType application/vnd.ms-fontobject eot
AddType application/x-font-ttf ttc ttf
AddType font/opentype otf

# Other
AddType application/octet-stream safariextz
AddType application/x-bb-appworld bbaw
AddType application/x-chrome-extension crx
AddType application/x-opera-extension oex
AddType application/x-xpinstall xpi
AddType text/vcard vcard vcf
AddType text/vnd.rim.location.xloc xloc
AddType text/vtt vtt
AddType text/x-component htc

</IfModule>

# UTF-8 encoding
AddDefaultCharset utf-8
<IfModule mod_mime.c>
AddCharset utf-8 .atom .css .js .json .manifest .rdf .rss .vtt .webapp .webmanifest .xml
</IfModule>

### End: MIME types ###

### Begin: Cross Origin ###

# Send the CORS header for images when browsers request it.
<IfModule mod_setenvif.c>
<IfModule mod_headers.c>
<FilesMatch "\.(bmp|cur|gif|ico|jpe?g|png|svgz?|webp)$">
SetEnvIf Origin ":" IS_CORS
Header set Access-Control-Allow-Origin "*" env=IS_CORS
</FilesMatch>
</IfModule>
</IfModule>

# Allow cross-origin access to web fonts.
<IfModule mod_headers.c>
<FilesMatch "\.(eot|otf|tt[cf]|woff2?)$">
Header set Access-Control-Allow-Origin "*"
</FilesMatch>
</IfModule>

### End: Cross Origin ###

### Begin: Rewriting and Access ###

# You need rewriting, if you use a URL-Rewriting extension (RealURL, CoolUri).

<IfModule mod_rewrite.c>

# Enable URL rewriting
RewriteEngine On

# Store the current location in an environment variable CWD to use
# mod_rewrite in .htaccess files without knowing the RewriteBase
RewriteCond $0#%{REQUEST_URI} ([^#]*)#(.*)\1$
RewriteRule ^.*$ - [E=CWD:%2]

# Rules to set ApplicationContext based on hostname
#RewriteCond %{HTTP_HOST} ^dev\.example\.com$
#RewriteRule .? - [E=TYPO3_CONTEXT:Development]
#RewriteCond %{HTTP_HOST} ^staging\.example\.com$
#RewriteRule .? - [E=TYPO3_CONTEXT:Production/Staging]
#RewriteCond %{HTTP_HOST} ^www\.example\.com$
#RewriteRule .? - [E=TYPO3_CONTEXT:Production]

# Rule for versioned static files, configured through:
# - $GLOBALS['TYPO3_CONF_VARS']['BE']['versionNumberInFilename']
# - $GLOBALS['TYPO3_CONF_VARS']['FE']['versionNumberInFilename']
# IMPORTANT: This rule has to be the very first RewriteCond in order to work!
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^(.+)\.(\d+)\.(php|js|css|png|jpg|gif|gzip)$ %{ENV:CWD}$1.$3 [L]

# Access block for folders
RewriteRule _(?:recycler|temp)_/ - [F]
RewriteRule fileadmin/templates/.*\.(?:txt|ts)$ - [F]
RewriteRule ^(?:vendor|typo3_src|typo3temp/logs) - [F]
RewriteRule (?:typo3conf/ext|typo3/sysext|typo3/ext)/[^/]+/(?:Configuration|Resources/Private|Tests?|Documentation|docs?)/ - [F]

# Block access to all hidden files and directories with the exception of
# the visible content from within the `/.well-known/` hidden directory (RFC 5785).
RewriteCond %{REQUEST_URI} "!(^|/)\.well-known/([^./]+./?)+$" [NC]
RewriteCond %{SCRIPT_FILENAME} -d [OR]
RewriteCond %{SCRIPT_FILENAME} -f
RewriteRule (?:^|/)\. - [F]

# Stop rewrite processing, if we are in the typo3/ directory or any other known directory
# NOTE: Add your additional local storages here
RewriteRule ^(?:typo3/|fileadmin/|typo3conf/|typo3temp/|uploads/|favicon\.ico) - [L]

# If the file/symlink/directory does not exist => Redirect to index.php.
# For httpd.conf, you need to prefix each '%{REQUEST_FILENAME}' with '%{DOCUMENT_ROOT}'.
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME} !-l
RewriteRule ^.*$ %{ENV:CWD}index.php [QSA,L]

</IfModule>

# Access block for files
<FilesMatch "(?i:^\.|^#.*#|^(?:ChangeLog|ToDo|Readme|License)(?:\.md|\.txt)?|^composer\.(?:json|lock)|^ext_conf_template\.txt|^ext_typoscript_constants\.txt|^ext_typoscript_setup\.txt|flexform[^.]*\.xml|locallang[^.]*\.(?:xml|xlf)|\.(?:bak|co?nf|cfg|ya?ml|ts|dist|fla|in[ci]|log|sh|sql(?:\..*)?|sw[op]|git.*)|.*(?:~|rc))$">
# Apache < 2.3
<IfModule !mod_authz_core.c>
Order allow,deny
Deny from all
Satisfy All
</IfModule>

# Apache ≥ 2.3
<IfModule mod_authz_core.c>
Require all denied
</IfModule>
</FilesMatch>

# Block access to vcs directories
<IfModule mod_alias.c>
RedirectMatch 404 /\.(?:git|svn|hg)/
</IfModule>

### End: Rewriting and Access ###

### Begin: Miscellaneous ###

# 404 error prevention for non-existing redirected folders
Options -MultiViews

# Make sure that directory listings are disabled.
<IfModule mod_autoindex.c>
Options -Indexes
</IfModule>

<IfModule mod_headers.c>
# Force IE to render pages in the highest available mode
Header set X-UA-Compatible "IE=edge"
<FilesMatch "\.(appcache|crx|css|eot|gif|htc|ico|jpe?g|js|m4a|m4v|manifest|mp4|oex|oga|ogg|ogv|otf|pdf|png|safariextz|svgz?|ttf|vcf|webapp|webm|webp|woff2?|xml|xpi)$">
Header unset X-UA-Compatible
</FilesMatch>

# Reducing MIME type security risks
Header set X-Content-Type-Options "nosniff"
</IfModule>

# ETag removal
<IfModule mod_headers.c>
Header unset ETag
</IfModule>
FileETag None

### End: Miscellaneous ###

# Add your own rules here.

</pre>

== Update auf 6.2 ==
=== Probleme mit dem index ===
https://forge.typo3.org/issues/61154

'''Fehlermeldung''' "Migrate all file links of RTE-enabled fields to FAL" fails with "Reference index was probably out of date."

Description

Meanwhile I did upgrades from TYPO3 4.7 to 6.2 for three different instances and every time I ran into this problem.
Reason are links in content elements of hidden or (from database point of view: logical) deleted pages where the target (usually the file in fileadmin) does not exist anymore.

cli_dispatch.phpsh lowlevel_refindex -c

does not detect these broken links. So this is a deadlock during migration.

I found this workaround which requires using a SQL client for the mysql database:
1) '''check''' if the result of this query matches the list of "Reference index was probably out of date" elements

select * from sys_refindex where softref_key = 'typolink_tag' AND ref_table = '_FILE';

2) If so you can '''update''' these records:

update sys_refindex set softref_key = 'typolink' where softref_key = 'typolink_tag' AND ref_table = '_FILE';

== Update 4.5 , 4.7 ==
=== Umlautprobleme ===
evtl. auch mal bei dbinit
<pre>
SET character_set_client = utf8;
SET character_set_results = utf8;
SET character_set_connection = utf8;
</pre>

Manchmal auch bei Darstellungsproblemen oder weißer Seite

Install-Tool nach dem Parameter "
systemLocale -> de_DE.utf8
'''Bis TYPO3 4.6''': im Install-Tool den Parameter
forceCharset -> utf-8
'''Ab TYPO3 4.7''': im '''Typoscript-Setup'''
config.renderCharset = utf-8
Im '''Install-Tool''' bei "
setDBinit -> SET NAMES utf8;
eintragen (ist ab TYPO3 4.7 bereits als Standard eingetragen).

Nun den kompletten Cache leeren. Jetzt sollten die Umlaute korrekt dargestellt werden.
</pre>
Falls Sie per GIFBUILDER Text in Bilder einbauen, versuchen Sie folgendes:
<pre>
Im Install-Tool beim Parameter "t3lib_cs_convMethod" den Wert "mbstring" eintragen.
Im Install-Tool beim Parameter "t3lib_cs_utils" ebenfalls " mbstring" eintragen.
</pre>
Falls Sie Templavoila verwenden, müssen Sie darauf achten, dass Ihr HTML-Editor die Datei UTF-8-kodiert speichert. In den meisten Editoren können Sie das in den Einstellungen anpassen.

Wenn immer noch Darstellungsprobleme auftreten, kann unter Umständen eine Konvertierung der Datenbank nötig sein.

== Update Infos 4.5 ==
* Weitere Tools werden separat installiert
* utf-8 für Datenbankverbindung wird vorausgesetzt (siehe auch Typo3 auf utf-8 umstellen)
** Install-Tool $TYPO3_CONF_VARS['SYS']['setDBinit'] und $TYPO3_CONF_VARS['BE']['forceCharset'] default haben sich verändert.

* Zugriff auf veraltete php-Funktionen werden geloggt. Vorsichtig Log kann groß werden
* Extbase und Fluid

== Update Infos 4.3 ==
* simulate_static_docs muss separat installiert werden
=== Update Wizard Info ===
'''CSS Styled Content: Default targets for non-frame pages'''

The default page target is empty (so no target is generated). If you use frames, you have to set target to "page" in Constants.

'''CSS Styled Content: htmlspecialchars in menu content elements'''

Page titles will get htmlspecialchar'ed when rendered in "Sitemap/menu" content elements, to avoid generating invalid XHTML.

'''htmlArea RTE: Using CSS classes for indentation and alignment'''

* Indentation is produced by a CSS class instead of the blockquote element.
You will need to specify in Page TSConfig the class to be used for indentation using property buttons.indent.useClass (default is "indent"). You will need to define this class in your stylesheets and ensure that it is allowed by the RTE transformation (RTE.default.proc). Alternatively, you may continue using the blockquote element by setting property buttons.indent.useBlockquote. You may also want to add the new blockquote button to the RTE toolbar.

* Text alignment is produced by CSS classes instead of deprecated align attribute.
You will need to specify in Page TSConfig the class to be used for each text alignment button using property buttons.[left, center, right or justifyfull].useClass (defaults are "align-left", "align-center", "align-right", "align-justify"). You will need to define these classes in your stylesheets, and ensure that they are allowed by the RTE transformation (RTE.default.proc). Alternatively, you may continue using deprecated align attribute by setting property buttons.[left, center, right or justifyfull].useAlignAttribute.

== Update alter Typo3 Installationen (<V.3.8)==
Aus der Mailing Liste Östereich:
- der Core ist relativ easy (fast) immer zu upgraden (muesst' eigentlich von
v3.3 auch gehen ;-) )
- Achte immer auf installierte Extensions
* wenn etwas nicht geht, mal soweit wie moeglich alle Extensions wegschalten (nicht loeschen!).
* dann zuschalten; wenns dann hakt, dann sieht man gleich welche ext "boese" ist.
* dann diese ext updaten, wenns keine updates gibt, mal danach googlen.
* wenns dann net geht, debuggen..

Weitere Probleme:

Alte TS Templates arbeiten noch mit CSet und Content als default Template. Nach umstellen auf css-styled-content muß evt. einiges angepasst werden:
== Update auf 4.2 ==
<pre>
Backup erstellen (sollte selbstverständlich sein)!
Notieren welche Extensions "Global" installiert wurden, da diese später wieder erneut installiert werden müssen
Resource herunterladen:
wget kent.dl.sourceforge.net/sourceforge/typo3/typo3_src-4.2.8.tar.gz
Source-Paket entpacken:
tar -xzf typo3_src-4.2.8.tar.gz
Im Verzeichnis typo3conf müssen Sie eine Datei mit dem Namen "ENALBE_INSTALL_TOOL" erstellen bzw. uploaden (ich mache das immer mit vi ENABLE_INSTALL_TOOL )
eventuell die Rechte und die Gruppe ändern
eventuell basedir_restriction anpassen (für Plesk siehe hier)
typo3_src Symlink löschen:
rm typo3_src
neuen Symlink anlegen:
ln -s ../../typo3_src-4.2.8/ typo3_src
(den richtigen Pfad zum Source-Verzeichnis eventuell anpassen)
index.php löschen und neu erstellen:
rm index.php
ln -s typo3_src/index.php index.php
alte Verzeichnisse löschen (media, tslib)
alte Dateien löschen (showpic.php)
fehlende Verzeichnisse erstellen:
typo3conf/l10n, typo3temp/temp, typo3temp/GB, typo3temp/pics, typo3temp/llxml/, typo3temp/cs/ (sofern diese nicht schon vorhanden sind)
Installtool aufrufen und "Basic Configuration" überprüfen; hier sollte alles im grünen Bereich sein. Wenn nicht entsprechende Probleme beheben.
"Update Wizard" ausführen
Im "Database Analyser" auf "Update required tables" auf "Compare" klicken und bestätigen
Ins Backend einloggen und alle "Global" installierten Extensions nachinstallieren
Im Ext Manager unter Settings "Enable unsupported extensions" aktivieren, da zur Zeit noch nicht alle Exentensions überprüft wurden.
Im Ext Manager unter "Import extensions" auf "Retrieve/Update" klicken, um die aktuelle Liste der Extensions herunterzuladen
(Sollte es dabei zu Fehlermeldungen kommen, muss u.U. auf curl umgestellt werden) Leider ist das neue TER 2.0 extrem speicherhungrig, so dass u.U. die Speicherbeschränkung von PHP nicht ausreicht. Wenn möglich sollten Sie also zuvor den verfügbaren Speicher von PHP auf min. 45MB(!) hochsetzen. Sollten Sie dazu keine Rechte haben oder soviel Speicher nicht zur Verfügung stellen wollen, können Sie sich dadurch behelfen, dass Sie die benötigten Extensions als .t3x-Dateien herunterladen und "von Hand" installieren.
Im Ext Manager die Sprache updaten
Eventuell veraltete local-installierte Extensions erneuern (z.B. TemplaVoila, static_info_tables u.ä.)
Nicht mehr benötigte "Local"-installierte Extensions entfernen, wie z.B. csh_de, htmlarea (ist jetzt eine "System"-Extension und sollte daher local deinstalliert werden)
</pre>
== Update auf 4.1 ==
Unbedingt im Install Tool Compare ausführen und Tabellen aktualisieren. Sonst kann es Probleme mit verschiedenen Extensions geben (z.B. Login..)

== Probleme beim TYPO3 Update lösen ==
=== Weiße Seite ===
* Fehlermeldungen einschalten
=== The requested URL /typo3/alt_main.php was not found on this server.===
Symlink für index.php falsch
=== Nach dem Datenbank Compare fehlen Teile der TYPOScript Templates ===

'''Lösung'''

Von Version 4.2 auf 4.1 werden blob Felder zu Text Feldern umgewandelt. Dabei werden bei Umlauten die Inhalte abgeschnitten, wenn die Datenbank utf-8 arbeitet, TYPO3 aber die Daten in latin abgelegt hat.

Beim Compare muß man dann die blob konvertierungen weglassen (vor allem bei den Templates - in der Regel gibt es da Kommentare mit Umlauten) und leicht abgewandelt selbst durchführen:

ALTER TABLE sys_template CHANGE config config TEXT CHARACTER SET latin1;

Typo3 läßt hier die Angabe welcher Zeichensatz drin ist weg.

Die wichtigsten Statements (Stand Typo3 4.5):

<pre>
ALTER TABLE sys_template CHANGE constants constants text CHARACTER SET latin1;
ALTER TABLE sys_template CHANGE config config text CHARACTER SET latin1;
ALTER TABLE tt_content CHANGE image image text CHARACTER SET latin1;
ALTER TABLE tt_content CHANGE media media text CHARACTER SET latin1;
ALTER TABLE tt_content CHANGE pages pages tinytext CHARACTER SET latin1;
ALTER TABLE tt_content CHANGE multimedia multimedia tinytext CHARACTER SET latin1;
ALTER TABLE pages CHANGE media media text CHARACTER SET latin1;
</pre>

Link: http://dev.mysql.com/doc/refman/5.1/en/alter-table.html (Zugriff: 10/2012)

== Release Notes Version 4.1 ==
Die wichtigsten Neuerungen
* IRRE (Inline Relational Record Editing)
* AJAX Page and File Tree
* Clean-up functions (command line scripts)(Über Extension lowlevel)
* Improved Extension Manager (less memory, stored extension list)
* UTF-8 for filenames
* Backend "Who is online"
* Frontend "Stay logged in" (Konfiguration mit new login box)
* MySQL InnoDB (Wird automatisch bei Neuinstallation zur Verfügung gestellt, wenn es in mySQL aktiviert ist)
* Speed up Backend with .htaccess http://typo3.org/development/articles/release-notes-41/page/4/)

=== Manuelles ändern der Tabellen auf InnoDB ===
Hinweis persönlich rate ich von INNODB und TYPO3 ab, besser ISAM nehmen
<pre>
alter table cache_hash ENGINE = INNODB;
alter table cache_imagesizes ENGINE = INNODB;
alter table cache_md5params ENGINE = INNODB;
alter table cache_pages ENGINE = INNODB;
alter table cache_pagesection ENGINE = INNODB;
alter table cache_typo3temp_log ENGINE = INNODB;
alter table fe_sessions ENGINE = INNODB;
alter table fe_session_data ENGINE = INNODB;
alter table index_fulltext ENGINE = INNODB;
alter table index_grlist ENGINE = INNODB;
alter table index_phash ENGINE = INNODB;
alter table index_rel ENGINE = INNODB;
alter table index_section ENGINE = INNODB;
alter table index_stat_search ENGINE = INNODB;
alter table index_stat_word ENGINE = INNODB;
alter table index_words ENGINE = INNODB;
alter table sys_log ENGINE = INNODB;
</pre>

== Generelle Informationen zum Update unter Linux ==
Quelle: typo3.net Mai 2006

Typo3 ist normalerweise sehr einfach upzudaten - allerdings müssen ein paar Dinge beachtet werden, um updatefähig zu bleiben:

* Es dürfen keine Änderungen an dem Typo3-Sourcecode gemacht worden sein. Falls dieses doch gemacht wurde, müssen natürlich diese Änderungen erst in die neue Version eingearbeitet werden.
* Installierte Extensions sollten möglichst immer LOCAL installiert worden sein. So bleiben diese nach dem Tausch des Typo3-Sourcecodes unberührt und funktionieren nach dem Update (meist) wie gewohnt. Es gibt nur selten den Fall, daß eine Typo3-Version eine Funktion nicht mehr verwendet, die es in der alten Version noch gab.
* Wenn sie HTML-Templates von GLOBAL installierten Erweiterungen direkt im Extensionordner modifiziert haben sollten, müssen diese erst z.B. in den fileadmin kopiert werden. Dann können Sie den Pfad zu dieser Datei im TypoScript anpassen.

Den Pfad finden Sie überigens mithilfe des TypoScript-Object-Browsers schnell. Meist ist er an der Stelle plugin.extensionname.templateFile zu finden.

[[Bild:T3_wichtigeVerzeichnisse.gif]]

Einige der wichtigsten Verzeichnisse

'''Das Update für mittwaldmedien Kunden'''
Für unsere Kunden ist es nun besonders einfach, die vorhandene Installation auf die aktuelle Version zu bringen. Sie müssen sich nur auf der Webseite http://www.typo3server.com einloggen. Nach dem Login finden Sie ein Menü mit einem Link zu dem Typo3-Versionsmanager. Dort können Sie mit einem Klick Ihren Account auf die neue Version updaten.

'''ToDo Versionsmanager für Geo-bit'''

'''Manuelles Update'''

Für diejenigen, die dieses Update manuell machen wollen oder müssen, sind die folgenden Schrittenötig. Die Beispiele - vor allem die Pfade - müssen natürlich angepasst werden. Die Beispiele gehen davon aus, daß Sie eine Verzeichnisstruktur angelegt haben, die dem obigen Bild entspricht.

1. Machen Sie zuerst eine Datensicherung von dem Typo3-Sourcen und Ihrem html-Ordner! Die Datenbank können Sie nun über diesen Befehl sichern:

mysqldump -u benutzername -p -B --add-drop-table datenbank > typo3DBSicherung.sql

Notfalls könnte auch ein Dump mit phpMyAdmin erstellt werden.

2. Verbinden Sie sich mit Ihrem Server über SSH.

3. Wechseln Sie das Verzeichnis auf einer Ebene über dem Rootverzeichnis Ihres Webservers.
z.B.: cd /home/www/p1234/

4. Laden Sie sich die neuen Typo3-Sourcen auf ihren Linuxrechner. Die aktuellen Sourcen finden Sie unter: http://typo3.org/download/packages/.

Die benötigte Datei hat das Format typo3_src-3.x.x.tar.gz

'''Beispiel:'''

wget belnet.dl.sourceforge.net/sourceforge/typo3/typo3_src-3.7.0.tar.gz

5. Entpacken Sie die Datei mit dem Kommando:

'''Beispiel:'''

tar -xzvf typo3_src-3.x.x.tar.gz

6. Ändern Sie nun die Rechte so, wie der bisherige Typo3-Sourcecode-Ordner sie hatte.

'''Beispiel:'''

chown p1234.ftponly typo3_src-3.7.0 -R

7. Entfernen Sie den alten symbolischen Link mit:

rm typo3_src

8. Legen Sie nun einen neuen Link an mit:

ln -s typo3_src-3.x.x typo3_src

(Die Versionsnummer müssen Sie natürlich noch anpassen.)

9. Nun muss die Datenbank noch aktualisiert werden:

Gehen Sie hierzu in das Typo3-Installtool und klicken Sie auf den 2. Menüpunkt Database Analyser. Mit einem Klick auf Compare werden die zu ändernden oder zu ergänzenden Datenbankfelder angezeigt. Mit einem Klick auf "Write to database" wird die Datenbank an die neue Typo3-Version angepasst.

10. Loggen Sie sich nun als Admin im Backend an und löschen Sie alle Caches.

== Neu in Version 4 ==
* Conditions mit AND und OR (|| &&)

== Neu in 4.2 ==
Viele Usability Verbesserungen im Backend
== Update auf 4.2 ==
=== Extensions Updaten ===
* dam 1.0.11 ist nicht kompatibel Update auf min. 1.0.13
* date2cal auf >= 7.1.0
* Kickstarter 0.3.8 ist nicht kompatibel
* Developer tools gehen nicht mehr (wg. Frame oben)

=== Ablauf ===
* Backend Benutzer sperren (only Admins)
* Sicherung der Datenbank
* neue Source + Symlink
* Update Wizard
* Compare

=== Probleme ===
'''DAM Upload geht für Benutzer''' nicht mehr (Fehler Meta Daten können nicht geschrieben werden)
Beim neu indizieren geht dem dam der Media Ordner verloren. Er legt dann einen neuen an, in den er scheiben möchte. Die Benutzer sind abe noch auf den alten eingestellt. D.h. die Benutzergruppen m´üssen auf den neuen eingestellt werden.

Im Dam stehen im IE7 die Benutzerwerkzeuge nicht zur verfügung (löschen etc.) nur der Stift ist noch da.

Lösung: Das Problem ist das CSS für das Fenster. Es verdeckt die restlichen Symbole
Forum: 24.7.

Ich hatte das gleiche Problem bis vor 5 Minuten auch,
gelöst habe ich es so:
- Datei: class.tx_dam_listbase.php im Ordner DAM\lib\
Unter der Zeile 256 ('itemTD' => ' class="typo3-dblist-item"',)
ist in 3 Werten als Breite 1% angegeben. Das auskommentieren

- Datei: stylesheet.cdd in typo3_src\typo3\
table.typo3-dblist width: 98%; durch width: auto; ersetzen und in
table.typo3-dblist tr td {width: auto;} einsetzen,

damit hats bei mir im IE 7, Firefox, safari für Win und Opera alles richtig angezeigt :-)

Ich hoffe, geholrfen zu haben,
Schmoozer

Bug in Mount Points

== Datenbank über Root Shell sichern (mysql backup) ==

mysqldump -opt ...

Beispiele

Die häufigste Anwendung von mysqldump ist wahrscheinlich die '''Erstellung eines Backups einer vollständigen Datenbank''':

shell> mysqldump --opt db_name > backup-file.sql

oder mit User und Passwortangabe:
mysqldump -u meinDBUser -pGEHEIM db_name > backup.sql

--opt ist in neueren MySQL Versionen Standardmäßig an deshalb lassen wir es mal weg.

Die Speicherauszugsdatei können Sie wie folgt '''wieder einspielen'''.

shell> mysql db_name < backup-file.sql

Oder aber so:

shell> mysql -e "source /path-to-backup/backup-file.sql" db_name

mysqldump ist ferner sehr nützlich zum Ausfüllen von Datenbanken durch Kopieren von Daten von einem MySQL Server auf einen anderen:

shell> mysqldump --opt db_name | mysql --host=remote_host -C db_name

Sie können mit einem einzigen Befehl einen Speicherauszug mehrerer Datenbanken erstellen:

shell> mysqldump --databases db_name1 [db_name2 ...] > my_databases.sql

Um einen Speicherauszug aller Datenbanken zu erstellen, verwenden Sie die Option --all-databases:

shell> mysqldump --all-databases > all_databases.sql

Bei InnoDB-Tabellen bietet mysqldump die Möglichkeit, eine Online-Sicherung zu erstellen:

shell> mysqldump --all-databases --single-transaction > all_databases.sql

Diese Datensicherung muss vor Beginn des Speicherauszugsvorgangs lediglich (mit FLUSH TABLES WITH READ LOCK) eine globale Lesesperre für alle Tabellen erwirken. Sobald diese Sperre aktiv ist, werden die Koordinaten des Binärlogs ausgelesen, und die Sperre wird aufgehoben. Wenn beim Absetzen der FLUSH-Anweisung gerade eine umfangreiche Änderungsanweisung ausgeführt wird, dann – und nur dann! – kann der MySQL Server stehen bleiben, bis diese lange Anweisung ausgeführt ist; danach ist der Server sperrfrei. Wenn die vom MySQL Server empfangenen Änderungsanweisungen (in Bezug auf ihre Ausführungsdauer) kurz sind, sollte die anfängliche Sperrperiode auch bei vielen Änderungen nicht spürbar sein.

Bei der Point-in-Time-Wiederherstellung (die auch als „Roll-Forward“ bezeichnet wird, wenn Sie ein altes Backup wiederherstellen und die seitdem durchgeführten Änderungen neu aufspielen müssen) ist es häufig nützlich, das Binärlog zu rotieren (siehe Abschnitt 5.12.3, „Die binäre Update-Logdatei“) oder zumindest die Binärlogkoordinaten zu kennen, denen der Speicherauszug entspricht:

shell> mysqldump --all-databases --master-data=2 > all_databases.sql

Oder:

shell> mysqldump --all-databases --flush-logs --master-data=2
> all_databases.sql

== Mass Update Script ==

Yesterday some updates came out for TYPO3. These updates fixed certain issues and we needed to update all of our excellent shared hosting environments.

We already have a script (which is more elaborate now) that checks all our TYPO3 installations and sends the sysadmins a nice report about its findings. We use part of that report (list of paths to Document Roots) to feed the updater script.

The TYPO3 update requires you to do the followi

* update encryption key
* clear configuration cache
* clear page cache

We do not want to go into 200+ TYPO3 backends and do those tasks manually. We are lazy and we will write a script to automagically do the boring tasks for us.

This script is not perfect but it works well on Debian systems. You can modify it to fit your needs. It was just a quick hack to ease the upgrade pain. Take care to switch the symlink part for upgrade runs of different versions of TYPO3.

I am not responsible for any damage to your system that may occur to misuse of this script. Make sure you understand it before you run it. Run it with a single URI before attempting a whole ist of URI's.

Ein Massen Update Script von:

http://typofree.org/article/archive/2009/january/title/typo3-mass-upgrade-script/
Zugriff am 12.3.2009

http://typofree.org/article/archive/2009/january/title/typo3-mass-upgrade-script/

TYPO3 mass update script

1.
#!/bin/sh
2.
binDir=/usr/bin/
3.
sleep=2
4.

5.
pageCacheTables=(
6.
cache_pages
7.
cache_pagesection
8.
)
9.

10.
sites=(
11.
/var/www/sites/live/www.somedomain.tld
12.
/var/www/sites/live/www.someotherdomain.tld
13.
/var/www/sites/live/www.yetsomeotherdomain.tld
14.
)
15.

16.
len=${#sites[*]}
17.
pageCacheTablesLength=${#pageCacheTables[*]}
18.
i=0
19.
while [ $i -lt $len ]; do
20.
echo updating: ${sites[$i]}
21.
cd ${sites[$i]}
22.
rm typo3_src
23.
ln -s ../../sources/typo3_src-4.2.5 typo3_src
24.

25.
echo generating new key
26.
k=0
27.
key=''
28.
while [ $k -lt 96 ]; do
29.
key=$key$(head -100 /dev/urandom | md5sum | cut -c1)
30.
let k++
31.
done
32.
echo key: $key
33.
sed -i "s/$\$TYPO3_CONF_VARS\['SYS']\['encryptionKey'] = $.*/\1'$key';/g" typo3conf/localconf.php
34.

35.
echo removing configuration cache
36.
rm -f typo3conf/temp_CACHED*
37.

38.
echo clearing page cache
39.
# For some insane reason some values are enclosed in double qotes
40.
database=$(grep "typo_db " typo3conf/localconf.php | tail -1 | sed "s/^[^']*'$[^']*$'.*/\1/" | grep '$typo_db =')
41.
if [ -z "$database" ] ; then
42.
database=$(grep "typo_db " typo3conf/localconf.php | tail -1 | sed "s/^[^']*'$[^']*$'.*/\1/")
43.
else
44.
database=$(grep "typo_db " typo3conf/localconf.php | tail -1 | sed "s/^[^\"]*\"$[^\"]*$\".*/\1/")
45.
fi
46.
username=$(grep "typo_db_username " typo3conf/localconf.php | tail -1 | sed "s/^[^']*'$[^']*$'.*/\1/" | grep '$typo_db_username =')
47.
if [ -z "$username" ] ; then
48.
username=$(grep "typo_db_username " typo3conf/localconf.php | tail -1 | sed "s/^[^']*'$[^']*$'.*/\1/")
49.
else
50.
username=$(grep "typo_db_username " typo3conf/localconf.php | tail -1 | sed "s/^[^\"]*\"$[^\"]*$\".*/\1/")
51.
fi
52.
password=$(grep "typo_db_password " typo3conf/localconf.php | tail -1 | sed "s/^[^']*'$[^']*$'.*/\1/" | grep '$typo_db_password =')
53.
if [ -z "$password" ] ; then
54.
password=$(grep "typo_db_password " typo3conf/localconf.php | tail -1 | sed "s/^[^']*'$[^']*$'.*/\1/")
55.
else
56.
password=$(grep "typo_db_password " typo3conf/localconf.php | tail -1 | sed "s/^[^\"]*\"$[^\"]*$\".*/\1/")
57.
fi
58.
j=0
59.
while [ $j -lt $pageCacheTablesLength ];
60.
do
61.
nice -n 19 ${binDir}mysql --batch -u$username -p"$password" -D$database -e "TRUNCATE ${pageCacheTables[$j]}"
62.
nice -n 19 ${binDir}mysql --batch -u$username -p"$password" -D$database -e "ALTER TABLE ${pageCacheTables[$j]} auto_increment=1"
63.
let j++
64.
done
65.

66.
echo "done! Sleeping $sleep seconds . . ."
67.
sleep $sleep
68.

69.
echo
70.
let i++
71.
done

All-inkl

2025-04-11T10:06:39Z

109.193.152.88: /* all-inkl Mailserver Ports */

== all-inkl Mailserver Ports==
<pre>
Server Ports
POP3: 110
POP3S: 995
IMAP: 143
IMAPS: 993
SMTP: 25 oder 587
SMTPS: 465
</pre>

SSL (nicht STARTTLS)

== Spezifische Einstellungen für all-inkl Accounts ==
== Begriffe ==
* CSR -> Certificate Request - braucht man für Certifikate von externen Signern normalerweise nicht
* Key -> Private Key
* CRT = CERT -> Das Zertifikat
* Brückenzertifikat, Intermediate Bundle, CA Zertifikat -> Das Zertifikat der Zertifizierungsstelle. Dies wird benötigt damit eine Zertifizierungsstelle als Certification Authority verifiziert werden kann. Wenn man ein selbstausgestelltes Zertifikat bei einer CA Zertifizieren will muß man das zusammen mit dem CRT abgeben.
* CA Certification Authority -> Eine Organisation (Zertifizierungsstelle) die für die Gültigkeit von Zertifikaten steht und diese Signieren kann.
== DNS E-Mail Einträge für Google Mail ==
<pre>
Nr Name Typ Data
1 [leer] A 85.13.144.174
2 * A 85.13.144.174
3 [leer] MX 1 aspmx.l.google.com.
4 leer MX 5 alt1.aspmx.l.google.com.
5 leer MX 10 spmx2.googlemail.com.
6 leer NS ns5.kasserver.com.
7 leer NS ns6.kasserver.com.
</pre>

== DNS Einträge für Microsoft 365 ==
Nameserver für Microsoft Office 365 (Outlook) einrichten
Beispiel BuG
(

Standardeinträge
<pre>
Name Typ Data
A 85.13.142.76
* A 85.13.142.76
NS ns5.kasserver.com.
NS ns6.kasserver.com.
</pre>
Microsoft 365 (Exchange)
<pre>
autodiscover CNAME autodiscover.outlook.com.
enterpriseenrollment CNAME enterpriseenrollment.manage.microsoft.com.
enterpriseregistration CNAME enterpriseregistration.windows.net.
TXT v=spf1 include:spf.protection.outlook.com -all
MX 0 baumundgarten-de01bb.mail.protection.outlook.com.
</pre>
Client Configuration?
msoid CNAME clientconfig.microsoftonline-p.net.

?
lyncdiscover CNAME webdir.online.lync.com.
Telefonanlage?
<pre>
_sip._tls SRV 100 1 443 sipdir.online.lync.com.
_sipfederationtls._tcp SRV 100 1 5061 sipfed.online.lync.com.
sip CNAME sipdir.online.lync.com.
</pre>

== DNS Einträge für Newsletter Anbieter ==
Wenn Du Newsletter z.B. über Newsletter2Go verschickst musst Du evtl. DNS Einträge setzen, damit du diese über deine Absender-Adresse senden kannst ohne dass Mails als Spam erkannt werden. So funktioniert es:

[[All-inkl - Newsletter Anbieter einrichten]]

== Eigene SSL Zertifikate ==
Kann man mittlerweile selbst einbinden. Im Kasserver unter
Domains > bearbeiten > SSL-Schutz
Dort kann man auch eigene erstellen (sind dann aber nicht von einer offiziellen Stelle signiert)

=== Eigene SSL Zertifikate mit CA Chain ===
Manchmal sind in einer Datei mehrere Zertifikatsteile abgelegt. Z.b. kann in einer .pem Datei das Zertifikat und das Brückenzertifikat liegen. Einfach mal reinschauen. Manchmal sind sie auch sinnvoll bezeichnet, z.B. '''cert+intermediate-ca.pem'''

=== Beispiel ===
Ins Webformular kommt bei

'''CSR''' ->normalerweise nichts, das braucht man nur für den Antrag

'''Key''' -> hier der Private Key

'''Key Passphrase''' -> braucht man wenn der Key Encrypted ist

'''CRT''' -> Hier kommt das Zertifikat rein (Inhalt der crt Datei)

'''Brückenzertifikate''' -> diese werden meistens benötigt und sind oft als Intermediate-, Bundle- oder CA Zertifikat oder CA Chain gekennzeichnet)

'''Wenn alles klappt kommen nach dem Speichern die Daten des Zertifikats z.B.'''

'''Inhaltsdaten CRT'''

'''Organisationseinheit [OU]'''

GT80198924
See www.rapidssl.com/resources/cps (c)15
Domain Control Validated - RapidSSL(R)

'''Gemeinsamer Name [CN]'''

www.dekra-sponsoring.de

'''Gültig'''

2015-05-19 bis 2016-07-20

'''SHA1 Fingerabdruck'''

00:5A:81:E9:06:35:C3:C2:02:1B:57:7A:DF:26:EB:90:A8:CA:11:A5

'''Schlüsselstärke'''

2048 bit

'''Signaturalgorithmus'''

sha256WithRSAEncryption

'''signiert von:'''

GeoTrust Inc., RapidSSL SHA256 CA - G3

'''Inhaltsdaten der Brückenzertifikate'''

'''SSL Zertifikat #1:'''

GeoTrust Inc., RapidSSL SHA256 CA - G3

'''signiert von:'''

GeoTrust Inc., GeoTrust Global CA

== SSL-Proxy ==
https://ssl-account.com/meineDomain.de/

== Pfade ==

== Siehe auch ==
[[TYPO3 - Sichere Backend und Frontend Benutzer mit rsaauth, ssl und saltedpasswords]]

All-inkl

2025-04-11T10:05:57Z

109.193.152.88: /* all-inkl Mailserver Ports */

== all-inkl Mailserver Ports==
<pre>
Server Ports
POP3: 110
POP3S: 995
IMAP: 143
IMAPS: 993
SMTP: 25 oder 587
SMTPS: 465
</pre>

SSL (normal nicht STARTTLS)

== Spezifische Einstellungen für all-inkl Accounts ==
== Begriffe ==
* CSR -> Certificate Request - braucht man für Certifikate von externen Signern normalerweise nicht
* Key -> Private Key
* CRT = CERT -> Das Zertifikat
* Brückenzertifikat, Intermediate Bundle, CA Zertifikat -> Das Zertifikat der Zertifizierungsstelle. Dies wird benötigt damit eine Zertifizierungsstelle als Certification Authority verifiziert werden kann. Wenn man ein selbstausgestelltes Zertifikat bei einer CA Zertifizieren will muß man das zusammen mit dem CRT abgeben.
* CA Certification Authority -> Eine Organisation (Zertifizierungsstelle) die für die Gültigkeit von Zertifikaten steht und diese Signieren kann.
== DNS E-Mail Einträge für Google Mail ==
<pre>
Nr Name Typ Data
1 [leer] A 85.13.144.174
2 * A 85.13.144.174
3 [leer] MX 1 aspmx.l.google.com.
4 leer MX 5 alt1.aspmx.l.google.com.
5 leer MX 10 spmx2.googlemail.com.
6 leer NS ns5.kasserver.com.
7 leer NS ns6.kasserver.com.
</pre>

== DNS Einträge für Microsoft 365 ==
Nameserver für Microsoft Office 365 (Outlook) einrichten
Beispiel BuG
(

Standardeinträge
<pre>
Name Typ Data
A 85.13.142.76
* A 85.13.142.76
NS ns5.kasserver.com.
NS ns6.kasserver.com.
</pre>
Microsoft 365 (Exchange)
<pre>
autodiscover CNAME autodiscover.outlook.com.
enterpriseenrollment CNAME enterpriseenrollment.manage.microsoft.com.
enterpriseregistration CNAME enterpriseregistration.windows.net.
TXT v=spf1 include:spf.protection.outlook.com -all
MX 0 baumundgarten-de01bb.mail.protection.outlook.com.
</pre>
Client Configuration?
msoid CNAME clientconfig.microsoftonline-p.net.

?
lyncdiscover CNAME webdir.online.lync.com.
Telefonanlage?
<pre>
_sip._tls SRV 100 1 443 sipdir.online.lync.com.
_sipfederationtls._tcp SRV 100 1 5061 sipfed.online.lync.com.
sip CNAME sipdir.online.lync.com.
</pre>

== DNS Einträge für Newsletter Anbieter ==
Wenn Du Newsletter z.B. über Newsletter2Go verschickst musst Du evtl. DNS Einträge setzen, damit du diese über deine Absender-Adresse senden kannst ohne dass Mails als Spam erkannt werden. So funktioniert es:

[[All-inkl - Newsletter Anbieter einrichten]]

== Eigene SSL Zertifikate ==
Kann man mittlerweile selbst einbinden. Im Kasserver unter
Domains > bearbeiten > SSL-Schutz
Dort kann man auch eigene erstellen (sind dann aber nicht von einer offiziellen Stelle signiert)

=== Eigene SSL Zertifikate mit CA Chain ===
Manchmal sind in einer Datei mehrere Zertifikatsteile abgelegt. Z.b. kann in einer .pem Datei das Zertifikat und das Brückenzertifikat liegen. Einfach mal reinschauen. Manchmal sind sie auch sinnvoll bezeichnet, z.B. '''cert+intermediate-ca.pem'''

=== Beispiel ===
Ins Webformular kommt bei

'''CSR''' ->normalerweise nichts, das braucht man nur für den Antrag

'''Key''' -> hier der Private Key

'''Key Passphrase''' -> braucht man wenn der Key Encrypted ist

'''CRT''' -> Hier kommt das Zertifikat rein (Inhalt der crt Datei)

'''Brückenzertifikate''' -> diese werden meistens benötigt und sind oft als Intermediate-, Bundle- oder CA Zertifikat oder CA Chain gekennzeichnet)

'''Wenn alles klappt kommen nach dem Speichern die Daten des Zertifikats z.B.'''

'''Inhaltsdaten CRT'''

'''Organisationseinheit [OU]'''

GT80198924
See www.rapidssl.com/resources/cps (c)15
Domain Control Validated - RapidSSL(R)

'''Gemeinsamer Name [CN]'''

www.dekra-sponsoring.de

'''Gültig'''

2015-05-19 bis 2016-07-20

'''SHA1 Fingerabdruck'''

00:5A:81:E9:06:35:C3:C2:02:1B:57:7A:DF:26:EB:90:A8:CA:11:A5

'''Schlüsselstärke'''

2048 bit

'''Signaturalgorithmus'''

sha256WithRSAEncryption

'''signiert von:'''

GeoTrust Inc., RapidSSL SHA256 CA - G3

'''Inhaltsdaten der Brückenzertifikate'''

'''SSL Zertifikat #1:'''

GeoTrust Inc., RapidSSL SHA256 CA - G3

'''signiert von:'''

GeoTrust Inc., GeoTrust Global CA

== SSL-Proxy ==
https://ssl-account.com/meineDomain.de/

== Pfade ==

== Siehe auch ==
[[TYPO3 - Sichere Backend und Frontend Benutzer mit rsaauth, ssl und saltedpasswords]]

All-inkl

2025-04-11T09:32:41Z

109.193.152.88: /* all-inkl Mailserver Ports */

== all-inkl Mailserver Ports==
<pre>
Server Ports
POP3: 110
POP3S: 995
IMAP: 143
IMAPS: 993
SMTP: 25 oder 587
SMTPS: 465
</pre>

SSL (normal nicht START)

== Spezifische Einstellungen für all-inkl Accounts ==
== Begriffe ==
* CSR -> Certificate Request - braucht man für Certifikate von externen Signern normalerweise nicht
* Key -> Private Key
* CRT = CERT -> Das Zertifikat
* Brückenzertifikat, Intermediate Bundle, CA Zertifikat -> Das Zertifikat der Zertifizierungsstelle. Dies wird benötigt damit eine Zertifizierungsstelle als Certification Authority verifiziert werden kann. Wenn man ein selbstausgestelltes Zertifikat bei einer CA Zertifizieren will muß man das zusammen mit dem CRT abgeben.
* CA Certification Authority -> Eine Organisation (Zertifizierungsstelle) die für die Gültigkeit von Zertifikaten steht und diese Signieren kann.
== DNS E-Mail Einträge für Google Mail ==
<pre>
Nr Name Typ Data
1 [leer] A 85.13.144.174
2 * A 85.13.144.174
3 [leer] MX 1 aspmx.l.google.com.
4 leer MX 5 alt1.aspmx.l.google.com.
5 leer MX 10 spmx2.googlemail.com.
6 leer NS ns5.kasserver.com.
7 leer NS ns6.kasserver.com.
</pre>

== DNS Einträge für Microsoft 365 ==
Nameserver für Microsoft Office 365 (Outlook) einrichten
Beispiel BuG
(

Standardeinträge
<pre>
Name Typ Data
A 85.13.142.76
* A 85.13.142.76
NS ns5.kasserver.com.
NS ns6.kasserver.com.
</pre>
Microsoft 365 (Exchange)
<pre>
autodiscover CNAME autodiscover.outlook.com.
enterpriseenrollment CNAME enterpriseenrollment.manage.microsoft.com.
enterpriseregistration CNAME enterpriseregistration.windows.net.
TXT v=spf1 include:spf.protection.outlook.com -all
MX 0 baumundgarten-de01bb.mail.protection.outlook.com.
</pre>
Client Configuration?
msoid CNAME clientconfig.microsoftonline-p.net.

?
lyncdiscover CNAME webdir.online.lync.com.
Telefonanlage?
<pre>
_sip._tls SRV 100 1 443 sipdir.online.lync.com.
_sipfederationtls._tcp SRV 100 1 5061 sipfed.online.lync.com.
sip CNAME sipdir.online.lync.com.
</pre>

== DNS Einträge für Newsletter Anbieter ==
Wenn Du Newsletter z.B. über Newsletter2Go verschickst musst Du evtl. DNS Einträge setzen, damit du diese über deine Absender-Adresse senden kannst ohne dass Mails als Spam erkannt werden. So funktioniert es:

[[All-inkl - Newsletter Anbieter einrichten]]

== Eigene SSL Zertifikate ==
Kann man mittlerweile selbst einbinden. Im Kasserver unter
Domains > bearbeiten > SSL-Schutz
Dort kann man auch eigene erstellen (sind dann aber nicht von einer offiziellen Stelle signiert)

=== Eigene SSL Zertifikate mit CA Chain ===
Manchmal sind in einer Datei mehrere Zertifikatsteile abgelegt. Z.b. kann in einer .pem Datei das Zertifikat und das Brückenzertifikat liegen. Einfach mal reinschauen. Manchmal sind sie auch sinnvoll bezeichnet, z.B. '''cert+intermediate-ca.pem'''

=== Beispiel ===
Ins Webformular kommt bei

'''CSR''' ->normalerweise nichts, das braucht man nur für den Antrag

'''Key''' -> hier der Private Key

'''Key Passphrase''' -> braucht man wenn der Key Encrypted ist

'''CRT''' -> Hier kommt das Zertifikat rein (Inhalt der crt Datei)

'''Brückenzertifikate''' -> diese werden meistens benötigt und sind oft als Intermediate-, Bundle- oder CA Zertifikat oder CA Chain gekennzeichnet)

'''Wenn alles klappt kommen nach dem Speichern die Daten des Zertifikats z.B.'''

'''Inhaltsdaten CRT'''

'''Organisationseinheit [OU]'''

GT80198924
See www.rapidssl.com/resources/cps (c)15
Domain Control Validated - RapidSSL(R)

'''Gemeinsamer Name [CN]'''

www.dekra-sponsoring.de

'''Gültig'''

2015-05-19 bis 2016-07-20

'''SHA1 Fingerabdruck'''

00:5A:81:E9:06:35:C3:C2:02:1B:57:7A:DF:26:EB:90:A8:CA:11:A5

'''Schlüsselstärke'''

2048 bit

'''Signaturalgorithmus'''

sha256WithRSAEncryption

'''signiert von:'''

GeoTrust Inc., RapidSSL SHA256 CA - G3

'''Inhaltsdaten der Brückenzertifikate'''

'''SSL Zertifikat #1:'''

GeoTrust Inc., RapidSSL SHA256 CA - G3

'''signiert von:'''

GeoTrust Inc., GeoTrust Global CA

== SSL-Proxy ==
https://ssl-account.com/meineDomain.de/

== Pfade ==

== Siehe auch ==
[[TYPO3 - Sichere Backend und Frontend Benutzer mit rsaauth, ssl und saltedpasswords]]

All-inkl

2025-04-11T09:30:39Z

109.193.152.88: /* all-inkl Mailserver */

== all-inkl Mailserver Ports==
<pre>
Server Ports
POP3: 110
POP3S: 995
IMAP: 143
IMAPS: 993
SMTP: 25 oder 587
SMTPS: 465
</pre>

== Spezifische Einstellungen für all-inkl Accounts ==
== Begriffe ==
* CSR -> Certificate Request - braucht man für Certifikate von externen Signern normalerweise nicht
* Key -> Private Key
* CRT = CERT -> Das Zertifikat
* Brückenzertifikat, Intermediate Bundle, CA Zertifikat -> Das Zertifikat der Zertifizierungsstelle. Dies wird benötigt damit eine Zertifizierungsstelle als Certification Authority verifiziert werden kann. Wenn man ein selbstausgestelltes Zertifikat bei einer CA Zertifizieren will muß man das zusammen mit dem CRT abgeben.
* CA Certification Authority -> Eine Organisation (Zertifizierungsstelle) die für die Gültigkeit von Zertifikaten steht und diese Signieren kann.
== DNS E-Mail Einträge für Google Mail ==
<pre>
Nr Name Typ Data
1 [leer] A 85.13.144.174
2 * A 85.13.144.174
3 [leer] MX 1 aspmx.l.google.com.
4 leer MX 5 alt1.aspmx.l.google.com.
5 leer MX 10 spmx2.googlemail.com.
6 leer NS ns5.kasserver.com.
7 leer NS ns6.kasserver.com.
</pre>

== DNS Einträge für Microsoft 365 ==
Nameserver für Microsoft Office 365 (Outlook) einrichten
Beispiel BuG
(

Standardeinträge
<pre>
Name Typ Data
A 85.13.142.76
* A 85.13.142.76
NS ns5.kasserver.com.
NS ns6.kasserver.com.
</pre>
Microsoft 365 (Exchange)
<pre>
autodiscover CNAME autodiscover.outlook.com.
enterpriseenrollment CNAME enterpriseenrollment.manage.microsoft.com.
enterpriseregistration CNAME enterpriseregistration.windows.net.
TXT v=spf1 include:spf.protection.outlook.com -all
MX 0 baumundgarten-de01bb.mail.protection.outlook.com.
</pre>
Client Configuration?
msoid CNAME clientconfig.microsoftonline-p.net.

?
lyncdiscover CNAME webdir.online.lync.com.
Telefonanlage?
<pre>
_sip._tls SRV 100 1 443 sipdir.online.lync.com.
_sipfederationtls._tcp SRV 100 1 5061 sipfed.online.lync.com.
sip CNAME sipdir.online.lync.com.
</pre>

== DNS Einträge für Newsletter Anbieter ==
Wenn Du Newsletter z.B. über Newsletter2Go verschickst musst Du evtl. DNS Einträge setzen, damit du diese über deine Absender-Adresse senden kannst ohne dass Mails als Spam erkannt werden. So funktioniert es:

[[All-inkl - Newsletter Anbieter einrichten]]

== Eigene SSL Zertifikate ==
Kann man mittlerweile selbst einbinden. Im Kasserver unter
Domains > bearbeiten > SSL-Schutz
Dort kann man auch eigene erstellen (sind dann aber nicht von einer offiziellen Stelle signiert)

=== Eigene SSL Zertifikate mit CA Chain ===
Manchmal sind in einer Datei mehrere Zertifikatsteile abgelegt. Z.b. kann in einer .pem Datei das Zertifikat und das Brückenzertifikat liegen. Einfach mal reinschauen. Manchmal sind sie auch sinnvoll bezeichnet, z.B. '''cert+intermediate-ca.pem'''

=== Beispiel ===
Ins Webformular kommt bei

'''CSR''' ->normalerweise nichts, das braucht man nur für den Antrag

'''Key''' -> hier der Private Key

'''Key Passphrase''' -> braucht man wenn der Key Encrypted ist

'''CRT''' -> Hier kommt das Zertifikat rein (Inhalt der crt Datei)

'''Brückenzertifikate''' -> diese werden meistens benötigt und sind oft als Intermediate-, Bundle- oder CA Zertifikat oder CA Chain gekennzeichnet)

'''Wenn alles klappt kommen nach dem Speichern die Daten des Zertifikats z.B.'''

'''Inhaltsdaten CRT'''

'''Organisationseinheit [OU]'''

GT80198924
See www.rapidssl.com/resources/cps (c)15
Domain Control Validated - RapidSSL(R)

'''Gemeinsamer Name [CN]'''

www.dekra-sponsoring.de

'''Gültig'''

2015-05-19 bis 2016-07-20

'''SHA1 Fingerabdruck'''

00:5A:81:E9:06:35:C3:C2:02:1B:57:7A:DF:26:EB:90:A8:CA:11:A5

'''Schlüsselstärke'''

2048 bit

'''Signaturalgorithmus'''

sha256WithRSAEncryption

'''signiert von:'''

GeoTrust Inc., RapidSSL SHA256 CA - G3

'''Inhaltsdaten der Brückenzertifikate'''

'''SSL Zertifikat #1:'''

GeoTrust Inc., RapidSSL SHA256 CA - G3

'''signiert von:'''

GeoTrust Inc., GeoTrust Global CA

== SSL-Proxy ==
https://ssl-account.com/meineDomain.de/

== Pfade ==

== Siehe auch ==
[[TYPO3 - Sichere Backend und Frontend Benutzer mit rsaauth, ssl und saltedpasswords]]

ProcessWire - Cronjob

2025-04-03T10:33:47Z

109.193.152.88:

Damit ein Cronjob Skript Zugriff auf die ProcessWire Funktionen hat kannst du einfach die index.php inkludieren.

Beachte, dass du bei Selektoren z.B. include=all angeben musst, wenn du auf Templates mit Zugriffsbeschränkungen zugreifst (z.B. wenn diese nur für eine Benutzergruppe zugelassen sind.

Beispiel Archivierungsskript für DEKRA Gewinnspiel:

<syntaxhighlight lang="php">
<?php namespace ProcessWire;
/**
*
* job.php
* Maintenance tasks called via cronjob
*/

//require_once('../index.php'); // Bootstrapping ProcessWire
//$pw_path = $_SERVER['DOCUMENT_ROOT'] . 'index.php';
$pw_path = __DIR__ . '/../index.php'; // passe den Pfad ggf. an
require_once($pw_path);
$archivedCount = moveAnswersToArchive(10);
echo "Verschobene Antworten: " . $archivedCount . chr(10);
echo " nomail"; // uncomment if you don't want cronjob mails

/**
* moveAnswersToArchive
* bewegt Antworten zu Fragen ins Archiv (Checkbox gewählt)
* Bewegt nur eine begrenzte Anzahl aus Effizienzgründen
* Wird vom export Tool automatisch aufgerufen
*/
function moveAnswersToArchive($limit = 3, $parentPage = 30321, $archieveTemplate = 'user-archieved-answer') {
$lockedQuestions = pages()->find("template=question, checkbox=1, sort=date, limit=3, include=all"); // include ist wichtig, da template zugriff eingeschränkt
//var_dump($lockedQuestions);
$c = 0;
$parent = pages()->get($parentPage);
if($lockedQuestions->count) {
foreach($lockedQuestions as $question) {
$answers = pages()->find("template=user-answer, pr_question={$question->id}, sort=date, limit={$limit}");
foreach($answers as $answer) {
$answer->template = $archieveTemplate;
$answer->parent = $parent;
if($answer->save()) {
$c++;
}
}
}
}

// Rückgabe der Anzahl der verschobenen Antworten
wire('log')->save('cronjob', 'Antworten archiviert: '. $c);
return $c;
}
</syntaxhighlight>

Zugangsschutz:

Hier gibt es verschiedene Methoden. Wenn es bei all-inkl läuft kannst du einfach einen htaccess Passwortschutz auf das Verzeichnis legen (über das kasserver Backend)

ProcessWire - Cronjob

2025-04-03T10:32:18Z

109.193.152.88: Die Seite wurde neu angelegt: „Damit ein Cronjob Skript Zugriff auf die ProcessWire Funktionen hat kannst du einfach die index.php inkludieren. Beachte, dass du bei Selektoren z.B. include=…“

ProcessWire - Multilanguage Website

2025-03-22T16:00:41Z

109.193.152.88: /* Lang Attribute */

Mehrsprachige Websites mit ProcessWire / Andere Default Sprache

== Links ==
* https://processwire.com/docs/multi-language-support/
* https://processwire.com/talk/topic/5518-multi-language-site/
* http://processwire.com/api/multi-language-support/multi-language-urls/
* https://processwire.com/talk/topic/9322-change-default-language-for-homepage/ (Modul Solution, mehr zur Anschauung)

== Einleitung ==
Es gibt mehrere Bereiche an die man denken muss. Einmal geht es um die Eingabe im Backend, die Ausgabe im Frontend, die Sprachnavigation auf der Website und die Templates:
* Wie übersetze ich Text in meinen '''Templates''' ? Siehe unten i18n
* Wie übersetze ich '''Inhalte''' im Backend ? Dafür ist das Modul Language Support Fields zuständig
* Wie sollen meine URLs aussehen ? Prinzipiell kann man jedem User unterschiedliche Sprachen auch ohne andere Domain liefern (über seine Session) aber i.d.R wollen wir die URL anzupassen.
** ''domain.de/en/meineSeite'' oder ''domain.de/myPage''
** Um '''Seitennamen''' zu übersetzen oder ein Domainkürzel in der URL voranzustellen benötige ich das Modul '''Language Support Page Names'''

== Welche Module benötige ich ==
Da es einige Module in diesem Zusammenhang gibt hier eine Übersicht. Man findet Sie am besten unter
Modules > Core > Language

* '''Languages Support''' - ProcessWire multi-language support. Basis Modul bracht man für alle Beispiele unten. Reicht aus, wenn man nur die Standard-Sprache ändern will. '''Hinweis:''' In der aktuellen PW3 Version schlägt einem ProcessWire nach Installation des Language Support Moduls gleich die Ergänzenden Module (s.u.) vor und man kann den Installationsprozess ziemlich fix erledigen.
* '''Languages Support - Fields''' Required to use multi-language fields. Basis für mehrsprachige Felder im Backend.
* '''Languages Support - Page Names''' (LanguageSupportPageNames) Required to use multi-language page names. Braucht man nur wenn '''alle Seiten in allen Sprachen unterschiedliche Namen''' bekommen sollen.
* '''Languages Support - Tabs''' Organizes multi-language fields into tabs for a cleaner easier to use interface.
Für mehrsprachige Seiten benötigen wir im Frontend i.d.R. folgende Module:
* '''Language Support Fields''' - Sind Felder, die im Backend für jede Sprache eine eigene Eingabe bieten.
* '''Language Support Page Names''' benötigt man, damit man für die Sprachen eigene URLs angeben kann. Z.B. bei Home in Englisch /en/ usw.
* '''FieldtypePageTitleLanguage''' benötigt man wenn man alle Seitenamen anpassen will (seite1_de seite1_fr ...) Für einen reinen Sprachpfad (/de/Seite) braucht man das nicht.

== Einsprachige Seite aber Deutsch als Default Sprache ==
Wenn nur die Standardsprache verändern möchte, aber keine Mehrsprachige Seite benötigt brauchen wir nur das Modul '''Language Support'''
* Enable languages support -> '''Core Module "Language Support" aktivieren'''. -> Sprachen stehen num im Backend Setup zur Verfügung
* '''Titel der Default Sprache''' anpassen (z.B. Deutsch (default) )
* Language Pack in der default Sprache installieren -> Dies ist ab jetzt die Default Sprache. Nicht vergessen auch den '''lang Tag im Header''' zu setzen, damit der Browser die Sprache richtig erkennt.

== Sprachpakete installieren ==
https://processwire.com/modules/category/language-pack/
* Sprache auswählen und dort komplettes zip hochladen.
* Informell (DU) leider im Moment nicht vorhanden

== Basis-Module für Mehrsprachigkeit im Backend ==
Für mehrsprachige Seiten benötigen wir i.d.R. folgende Module:
* '''Language Support Fields''' für die Backend Übersetzungen und '''Language Support Page Names''' für die URLs.
* '''FieldtypePageTitleLanguage''' benötigt man wenn man alle Seitenamen anpassen will (seite1_de seite1_fr ...) Für einen reinen Sprachpfad (/de/Seite) braucht man das nicht.
* Für weitere Sprachen entsprechend hinzufügen.
Vorgehen:
* Language Packs installieren: drop in the none english language pack (for admin backend) into the default language, (e.g. german langpack)
* As a nice sideeffect every new user in your system gets the native language per default without have it to select from the list.

== Templates für Multilanguage vorbereiten (i18n) ==
https://processwire.com/docs/multi-language-support/code-i18n/
https://processwire.com/blog/posts/functional-fields/
=== Functional fields ===
In PW3 kamen die functional Fields hinzu. Mit diesen kann man statischen Text dynamisch im Page Editor ansprechen. D.h. das Functional Field findet Texte im Template und macht sie automatisch editierbar im Page Editor. Das Ganze funktioniert auch Mehrsprachig.
[[ProcessWire - Functional Fields]]
https://processwire.com/blog/posts/functional-fields/
Beispiele für die Ausgabe von
<pre>
__text('your text');
__textarea('your text');
__richtext('<p>your text</p>');
__text('Subscribe Now', 'subscribe') // define a identifier for this text snippet...
__text('subscribe') // ..reuse it this way
$pages->get('/')->mytext->subscribe // reuse from another template
__text('Subscribe Now', 'subscribe', 'Submit button'); // Label for page editor
__text('Subscribe Now', 'subscribe', 'label=Submit button, notes=Test'); // or use a pw selector
__text('Subscribe Now', 'name=subscribe, label=Submit button, notes=Test'); // equivalent to upper

</pre>

=== Standard Multilanguage nach i18n ===

$out = $this->_("Live long and prosper"); // syntax within a class
$out = __("Live long and prosper!"); // syntax outside of a class

Dann im Backend unter der Sprache "Find files to translate" und die Template Datei auswählen.

=== Variablen in i18n ===
$out = sprintf(__("Created %d pages."), $count);
$out = sprintf(__('Your city is %1$s, and your zip code is %2$s.'), $city, $zipcode);

=== Plural in Multilanguage Files===
Hierzu gibt es die _n() Funktion
$out = sprintf(_n("Created %d page.", "Created %d pages.", $count), $count);
=== Unterschiedliche Übersetzungen bei gleichem Wortlaut ===
Manchmal muss der Begriff in anderen Sprachen unterschiedlich übersetzt werden, obwohl er in der Default Sprache gleich lautet:
<pre>
$label = _x('Comment', 'noun'); // or $this->_x('Comment', 'noun') in a class
...
// some other place in the code
echo _x('Comment', 'column name');
</pre>

=== Kommentare für den Übersetzer und User ===
$date = __('g:i:s a'); // Date string in PHP date() format
echo __("Welcome Guest"); // Headline for guest user // Keep it short (2-3 words)
=== Regeln ===
* Eine Zeile ein Paar Anführungszeichen
* Nur eine Übersetzungsfunktion pro Zeile

== Language Switcher ==
<syntaxhighlight lang="php">
// remember what language is set to
$savedLanguage = $user->language;

foreach($languages as $language) {

// if user is already viewing the page in this language, skip it
if($language->id == $savedLanguage->id) continue;

// if this page isn't viewable (active) for the language, skip it
if(!$page->viewable($language)) continue;

// set the user's language, so that the $page->url and any other
// fields we access from it will be reflective of the $language
$user->language = $language;

// output a link to this page in the other language
echo "<li><a href='$page->url'>$language->title: $page->title</a></li>";
}
// restore the original language setting
$user->language = $savedLanguage;
</syntaxhighlight>

== Seiten nur in einer Sprache verfügbar ==
What If I want to create/publish a page only in DE language, and that page should not be available in the default language?
Default language is required. But you could always add your own checkbox field to the page as a toggle to disable it. Your head.inc or _init.php or whatever your common initialization file is could check:

if($page->disable_default_language && $user->language->isDefault()) throw new Wire404Exception();
You'd also have to consider it with navigation generation, perhaps skipping over pages that have the toggle set while in the default language, or adding it to your selectors when querying pages.

Edit: you could also just choose to not use the default language at all.

if($user->language->isDefault()) $user->language = $languages->get("en-us"); // or whatever you want your default to be

== Language Alternate Fields ==
Eine Möglichkeit alle Felder (auch Bilder) in verschiedenen Sprachen zu nutzen.
https://processwire.com/docs/multi-language-support/multi-language-fields/#language-alternate-fields

== Probleme lösen ==
=== Feldtyp nicht als Multilanguagefeld vorhanden - Language Alternate Field ===
Manche Felder (z.B. AssistedUrl) gibt es nur einsprachig. ProcessWire bietet aber mit den '''Language Alternate Fields''' eine Möglichkeit solche Felder mehrsprachig zu nutzen. Dazu braucht man kein Modul. Es ist eine Basis Funktionalität.

Dazu legt man für jede zusätzliche Sprache ein weiteres Feld mit dem selben Namen + der Namenserweiterung _sprachname an. Beispielsweise kann man für ein Feld Namens link ein weiteres Feld Namens '''link_en''' anlegen. Dann nutzt ProcessWire automatisch für die Sprache mit dem Namen '''en'''

== Beispiele ==

=== Multilanguage Page - Quickstart ===

==== 1. Module ====
* s.o. alle benötigten installieren

==== 2. Backend ====
* Default Sprache festlegen
** Wenn nicht Englisch Sprachpaket installieren
** Wenn der Titel der Sprache auch der Identifier für den html Tag sein soll muss er ''de, en, fi''... lauten
* Weitere Sprachen hinzufügen. Für Englisch benötigt man kein Sprachpaket. Als Name am besten den offiziellen Code (de, en...) vergeben.
* Die Homepage entscheidet über den Pfad. Wenn Englisch z.B. unter www.meineSeite.com/en/seitenname/ erreichbar sein soll, dann muss für Englisch unter '''Einstellung > Namen en''' eingetragen werden.
* Alle Felder die Übersetzt werden sollen auf Multilanguage Felder umstellen

==== 3. Templates ====
===== Lang Attribute =====

Das '''lang Attribut''' sollte zur Sprache passen.

'''Möglichkeit 1:'''

Mit der _x Funktion kann PW beliebige Strings in Templates übersetzten. PW findet diese automatisch.
_main.php (oder header..)
<html lang="<?php echo _x('en', 'HTML language code'); ?>">
Im '''Backend''' muss man zunächst für Englisch den '''Sprachindex aufbauen''' ('''Spracheinstellungen Verwaltung > Sprachen > Englisch''')

Dann kann man nun in den '''Spracheinstellungen Verwaltung > Sprachen > meineSprache''' das Label ''HTML language code'' suchen und mit dem passenden lang tag ersetzen.

Das Funktioniert auch mit beliebigen anderen Werten die man im Template hartkodiert hat.

'''Möglichkeit 2 (bevorzugt weil schnell):'''

Man kann auch den Language Title verwenden wenn dieser entsprechend vergeben wurde (en, de,...) .

'''Nachteil:''' Dann kann man aber den Titel nicht mehr frei verändern wenn man ihn auch als Bezeichnung für den Language Switcher nutezn möchte. Der Titel für default heißt dann z.B. de und zwar auch in der englischen Übersetzung. '''Also nicht in der Übersetzung "german" schreiben sondern auch de oder einfach gar nichts.'''

<html lang="<?= $user->language->title ?>">

Wenn du trotzdem irgendwelche ausgeschriebenen Label benötigst kannst du dir von Hand Variablen definieren und Übersetzen (z.B. mit der Übersetzungsfunktion __('de') oder_x('de', 'Label für deutsch');

==== 4. Language Switcher ====
'''Text Navigation''' z.B. so:
<syntaxhighlight lang="php">
<?php namespace ProcessWire;

?>
<ul id="nav-lang" class="nav nav-h">
<?php
foreach($languages as $language){
if(!$page->viewable($language)) continue; // is page viewable in this language?
if($language->id == $user->language->id) {
echo "<li class='current'>";
} else {
echo "<li>";
}
$url = $page->localUrl($language);
$hreflang = $pages->get('/')->getLanguageValue($language, 'name');
echo '<a hreflang="'.$hreflang.'" href="'.$url.'" style="text-transform:uppercase;">'.$language->title.'</a></li>';
echo "</li>";
}
?>
</ul>
</syntaxhighlight>

=====Textnavigation mit first/last etc. Klassen=====

<syntaxhighlight lang="php">
<?php namespace ProcessWire;

?>
<ul id="nav-lang" class="nav nav-h">
<?php
$n = $languages->count();
$i = 0;

$separator = '<span class="separator">|</span>';
foreach($languages as $language){
$liClass = array();
if(!$page->viewable($language)) continue; // is page viewable in this language?
$i++;
if( $i == 1 ) $liClass[] = "first";
if( $i == $n ) $liClass[] = "last";
if($language->id == $user->language->id) $liClass[] = 'current';
echo '<li class="'.implode(' ',$liClass).'">';
$url = $page->localUrl($language);
$hreflang = $pages->get('/')->getLanguageValue($language, 'name');
echo '<a hreflang="'.$hreflang.'" href="'.$url.'" style="text-transform:uppercase;">'.$language->title.'</a></li>';
if( $i < $n ) echo $separator;
echo "</li>";
}
?>
</ul>
</syntaxhighlight>

=====Flaggennavi=====
z.B. so :
<syntaxhighlight lang="php">
<?php namespace ProcessWire;

?>
<ul id="nav-lang" class="">
<?php
foreach($languages as $language){
if(!$page->viewable($language)) continue; // is page viewable in this language?
if($language->id == $user->language->id) {

echo '<li class="current" style="opacity:0.5;">';
} else {
echo '<li>';
}
$flag = urls()->templates.'assets/flag-'.$language->name.'.png';
$url = $page->localUrl($language);
$hreflang = $pages->get('/')->getLanguageValue($language, 'name');
echo '<a hreflang="'.$hreflang.'" href="'.$url.'"><img class="flag" src="'.$flag.'" style="width: 100px;"></a></li>';
echo '</li>';
}
?>
</ul>
</syntaxhighlight>

===== Language Toggle Schiebeschalter =====
'''PHP-Script für schnelles erstellen eines Schiebeschalters'''
Bezieht sich auf das CSS für den fixed width Schalter
<syntaxhighlight lang="php">
<?php namespace ProcessWire;
/**
* langtoggle.inc
* User is en, show de toggle. User en, show de toggle
* Setze das title Feld der jeweiligen Sprache so wie du die Label haben möchtest
*
* Example SCSS:
* https://wiki.stephanschlegel.de/index.php?title=ProcessWire_-_Multilanguage_Website#4._Language_Switcher
*/

$langtoggle = '';
$user->language->name == 'en' ? $targetlangName = 'default' : $targetlangName = 'en'; //setzt voraus, das die name-Felder der Sprachen en und default sind. default ist immer der name der Standarssprache

foreach($languages as $language){
if(!$page->viewable($language)) continue;
if($language->id == $user->language->id) {
// button für diese Sprache wird nicht benötigt
// du könntest hier auch eine gedimmte Version nehmen
}else{
// URL der aktuellen Seite für die Zielsprache
$url = $page->localUrl($language);
//bd($url, 'langtoggle: target url');

$langtoggle .= '
<div class="language-switcher-fixed">
<a href="'.$url.'" class="toggle-switch '.$language->name.'" title="'.$language->title.'">
<div class="switch">
<div class="knob"></div>
<div class="label">'.$language->title.'</div>
</div>
</a>
</div>
';
}
}
?>
</syntaxhighlight>

'''CSS für fixed width Schiebeschalter mit Parametern'''
<syntaxhighlight lang="scss">
// Toggle Params
$switch-background-color :#006B52;
$switch-background-color-hover: #4a9a14;
$switch-label-color: #fff;
$switch-border-color: rgba(255, 255, 255, 0.642
);
$knob-color: #006B52;
$knob-border-color: transparent;
$knob-background-color: #fff;
$switch-width: 60px; // change this
$switch-border-thickness: 2px; // change this
$knob-gap: 5px; // change this (distance to border)
$switch-outer-width: $switch-width + 2 * $switch-border-thickness; // compensate border space
$switch-height: floor(($switch-width + 2 * $switch-border-thickness) / 2);
$switch-border-radius: ceil($switch-height / 2 + 2 * $switch-border-thickness);
$switch-label-font-size: floor($switch-height / 2);
$switch-label-width: floor($switch-width / 2);
$switch-label-distance: floor($switch-border-radius / 3);
$knob-height: (
floor($switch-width / 2) - ((2 * $knob-gap) + 2px)
);
$knob-width: $knob-height;

/* fixed width */

.language-switcher-fixed {
// display: flex;
// gap: 1rem;

.toggle-switch {
text-decoration: none;
display: inline-block;

.switch {
position: relative;
width: $switch-outer-width;
height: $switch-height;
background-color: $switch-background-color;
border-radius: $switch-border-radius;
border: $switch-border-thickness solid $switch-border-color;
transition: background-color 0.3s ease;
}

.knob {
position: absolute;
top: $knob-gap;
width: $knob-width;
height: $knob-height;
background-color: $knob-background-color;
border-radius: 50%;
border: $switch-border-thickness solid $knob-border-color;
transition: all 0.3s ease;
}

.label {
position: absolute;
top: 50%;
transform: translateY(-50%);
font-size: $switch-label-font-size;
font-weight: bold;
text-transform: uppercase;
color: $switch-label-color;
width: $switch-label-width;
text-align: center;
}
}

/* Default Schalter: Knopf links, Beschriftung rechts */
.toggle-switch.default {
.knob {
left: $knob-gap;
}

.label {
right: $switch-label-distance;
}
}

/* Englischer Schalter: Knopf rechts, Beschriftung links */
.toggle-switch.en {
.knob {
right: $knob-gap;
}

.label {
left: $switch-label-distance;
}
}

/* Hover- und Active-Effekte */
.toggle-switch:hover .switch {
background-color: $switch-background-color-hover;
}

.toggle-switch:active .knob {
transform: scale(0.95);
}

}
</syntaxhighlight>

''' Allgemeiner code (Beispiel mit dynamischer Breite enthalten '''
Siehe auch Codepen "Kholja"
<syntaxhighlight lang="html5">
<h2>Fixed width label</h2>

<div class="language-switcher-fixed">

<a href="/en" class="toggle-switch en" title="Wechsel zu Englisch">
<div class="switch">
<div class="knob"></div>
<div class="label">en</div>
</div>
</a>


<a href="/de" class="toggle-switch de" title="Wechsel zu Deutsch">
<div class="switch">
<div class="knob"></div>
<div class="label">de</div>
</div>
</a>
</div>

<h2>Dynamic width label</h2>
<div class="language-switcher-dynamic">

<a href="/de" class="toggle-switch de" title="Wechsel zu Deutsch">
<div class="switch">
<div class="knob"></div>
<span class="label">Deutsch</span>
</div>
</a>


<a href="/en" class="toggle-switch en" title="Wechsel zu Englisch">
<div class="switch">
<div class="knob"></div>
<span class="label">English</span>
</div>
</a>
</div>
</syntaxhighlight>

<syntaxhighlight lang="scss">
// Toggle Params
$switch-background-color :#006B52;
$switch-background-color-hover: #4a9a14;
$switch-label-color: #fff;
$switch-border-color: rgba(255, 255, 255, 0.642
);
$knob-color: #006B52;
$knob-border-color: transparent;
$knob-background-color: #fff;
$switch-width: 60px; // change this
$switch-border-thickness: 2px; // change this
$knob-gap: 5px; // change this (distance to border)
$switch-outer-width: $switch-width + 2 * $switch-border-thickness; // compensate border space
$switch-height: floor(($switch-width + 2 * $switch-border-thickness) / 2);
$switch-border-radius: ceil($switch-height / 2 + 2 * $switch-border-thickness);
$switch-label-font-size: floor($switch-height / 2);
$switch-label-width: floor($switch-width / 2);
$switch-label-distance: floor($switch-border-radius / 3);
$knob-height: (
floor($switch-width / 2) - ((2 * $knob-gap) + 2px)
);
$knob-width: $knob-height;

/* fixed width */

.language-switcher-fixed {
// display: flex;
// gap: 1rem;

.toggle-switch {
text-decoration: none;
display: inline-block;

.switch {
position: relative;
width: $switch-outer-width;
height: $switch-height;
background-color: $switch-background-color;
border-radius: $switch-border-radius;
border: $switch-border-thickness solid $switch-border-color;
transition: background-color 0.3s ease;
}

.knob {
position: absolute;
top: $knob-gap;
width: $knob-width;
height: $knob-height;
background-color: $knob-background-color;
border-radius: 50%;
border: $switch-border-thickness solid $knob-border-color;
transition: all 0.3s ease;
}

.label {
position: absolute;
top: 50%;
transform: translateY(-50%);
font-size: $switch-label-font-size;
font-weight: bold;
text-transform: uppercase;
color: $switch-label-color;
width: $switch-label-width;
text-align: center;
}
}

/* Default Schalter: Knopf links, Beschriftung rechts */
.toggle-switch.default {
.knob {
left: $knob-gap;
}

.label {
right: $switch-label-distance;
}
}

/* Englischer Schalter: Knopf rechts, Beschriftung links */
.toggle-switch.en {
.knob {
right: $knob-gap;
}

.label {
left: $switch-label-distance;
}
}

/* Hover- und Active-Effekte */
.toggle-switch:hover .switch {
background-color: $switch-background-color-hover;
}

.toggle-switch:active .knob {
transform: scale(0.95);
}

}
</syntaxhighlight>

=== Prantner ===
Hauptnavigation mit Flaggen:

language-switcher.inc
<syntaxhighlight lang="php">
<?php namespace ProcessWire;
$imgMarkup = "";
$out = "";
foreach($languages as $language) {
if(!$page->viewable($language)) continue; // is page viewable in this language?
$url = $page->localUrl($language);
$hreflang = $homepage->getLanguageValue($language, 'name');
$imgUrl = $config->urls->templates.'assets/flags/'.$language->name.'_sq.png';
$imgMarkup = "<img src=\"$imgUrl\" title=\"$language->title\" alt=\"$language->title\" class=\"circle z-depth-1\">";
if($language->id == $user->language->id) {
$out .= "<span class=\"lang-button current\">";
} else {
$out .= "<span class=\"lang-button\">";
}
$out .= "<a hreflang=\"$hreflang\" href=\"$url\">$imgMarkup</a></span>";
}
$out = '<div id="nav-lang">'.$out.'</div>';
echo $out;
?>
</syntaxhighlight>

language-switcher-mobile.inc
<syntaxhighlight lang="php">
<?php namespace ProcessWire;
?>
<ul id="nav-mobile" class="right hide-on-med-and-down">
<?php
foreach($languages as $language) {
if(!$page->viewable($language)) continue; // is page viewable in this language?
if($language->id == $user->language->id) {
echo "<li class='current'>";
} else {
echo "<li>";
}
$url = $page->localUrl($language);
$hreflang = $homepage->getLanguageValue($language, 'name');
echo "<a hreflang='$hreflang' href='$url'>$language->title</a></li>";
}
?>
</ul>
</syntaxhighlight>

== Language Snippets ==
=== URL der Sprache ===
$language = $user->language;
$page->getLanguageValue($language->id, 'url'); // getLanguageValue kann auf verschiedene Werte des language Objekts zugreifen hier auf die 'url' z.B. "/" bei Homepage oder "/en/"
$page->localUrl($language->id); // Kurzform von oberem Beispiel
$page->localHttpUrl($language->id); // Absolute URL z.B. 'https://100.dekra-online.de/en/'

=== Field Label in aktueller Sprache ===
fields($f)->getLabel()
Wobei $f ein Feldname sein kann aber auch ein Feldobjekt.

ProcessWire - Multilanguage Website

2025-03-22T11:51:07Z

109.193.152.88: /* Language Toggle Schiebeschalter */

Mehrsprachige Websites mit ProcessWire / Andere Default Sprache

== Links ==
* https://processwire.com/docs/multi-language-support/
* https://processwire.com/talk/topic/5518-multi-language-site/
* http://processwire.com/api/multi-language-support/multi-language-urls/
* https://processwire.com/talk/topic/9322-change-default-language-for-homepage/ (Modul Solution, mehr zur Anschauung)

== Einleitung ==
Es gibt mehrere Bereiche an die man denken muss. Einmal geht es um die Eingabe im Backend, die Ausgabe im Frontend, die Sprachnavigation auf der Website und die Templates:
* Wie übersetze ich Text in meinen '''Templates''' ? Siehe unten i18n
* Wie übersetze ich '''Inhalte''' im Backend ? Dafür ist das Modul Language Support Fields zuständig
* Wie sollen meine URLs aussehen ? Prinzipiell kann man jedem User unterschiedliche Sprachen auch ohne andere Domain liefern (über seine Session) aber i.d.R wollen wir die URL anzupassen.
** ''domain.de/en/meineSeite'' oder ''domain.de/myPage''
** Um '''Seitennamen''' zu übersetzen oder ein Domainkürzel in der URL voranzustellen benötige ich das Modul '''Language Support Page Names'''

== Welche Module benötige ich ==
Da es einige Module in diesem Zusammenhang gibt hier eine Übersicht. Man findet Sie am besten unter
Modules > Core > Language

* '''Languages Support''' - ProcessWire multi-language support. Basis Modul bracht man für alle Beispiele unten. Reicht aus, wenn man nur die Standard-Sprache ändern will. '''Hinweis:''' In der aktuellen PW3 Version schlägt einem ProcessWire nach Installation des Language Support Moduls gleich die Ergänzenden Module (s.u.) vor und man kann den Installationsprozess ziemlich fix erledigen.
* '''Languages Support - Fields''' Required to use multi-language fields. Basis für mehrsprachige Felder im Backend.
* '''Languages Support - Page Names''' (LanguageSupportPageNames) Required to use multi-language page names. Braucht man nur wenn '''alle Seiten in allen Sprachen unterschiedliche Namen''' bekommen sollen.
* '''Languages Support - Tabs''' Organizes multi-language fields into tabs for a cleaner easier to use interface.
Für mehrsprachige Seiten benötigen wir im Frontend i.d.R. folgende Module:
* '''Language Support Fields''' - Sind Felder, die im Backend für jede Sprache eine eigene Eingabe bieten.
* '''Language Support Page Names''' benötigt man, damit man für die Sprachen eigene URLs angeben kann. Z.B. bei Home in Englisch /en/ usw.
* '''FieldtypePageTitleLanguage''' benötigt man wenn man alle Seitenamen anpassen will (seite1_de seite1_fr ...) Für einen reinen Sprachpfad (/de/Seite) braucht man das nicht.

== Einsprachige Seite aber Deutsch als Default Sprache ==
Wenn nur die Standardsprache verändern möchte, aber keine Mehrsprachige Seite benötigt brauchen wir nur das Modul '''Language Support'''
* Enable languages support -> '''Core Module "Language Support" aktivieren'''. -> Sprachen stehen num im Backend Setup zur Verfügung
* '''Titel der Default Sprache''' anpassen (z.B. Deutsch (default) )
* Language Pack in der default Sprache installieren -> Dies ist ab jetzt die Default Sprache. Nicht vergessen auch den '''lang Tag im Header''' zu setzen, damit der Browser die Sprache richtig erkennt.

== Sprachpakete installieren ==
https://processwire.com/modules/category/language-pack/
* Sprache auswählen und dort komplettes zip hochladen.
* Informell (DU) leider im Moment nicht vorhanden

== Basis-Module für Mehrsprachigkeit im Backend ==
Für mehrsprachige Seiten benötigen wir i.d.R. folgende Module:
* '''Language Support Fields''' für die Backend Übersetzungen und '''Language Support Page Names''' für die URLs.
* '''FieldtypePageTitleLanguage''' benötigt man wenn man alle Seitenamen anpassen will (seite1_de seite1_fr ...) Für einen reinen Sprachpfad (/de/Seite) braucht man das nicht.
* Für weitere Sprachen entsprechend hinzufügen.
Vorgehen:
* Language Packs installieren: drop in the none english language pack (for admin backend) into the default language, (e.g. german langpack)
* As a nice sideeffect every new user in your system gets the native language per default without have it to select from the list.

== Templates für Multilanguage vorbereiten (i18n) ==
https://processwire.com/docs/multi-language-support/code-i18n/
https://processwire.com/blog/posts/functional-fields/
=== Functional fields ===
In PW3 kamen die functional Fields hinzu. Mit diesen kann man statischen Text dynamisch im Page Editor ansprechen. D.h. das Functional Field findet Texte im Template und macht sie automatisch editierbar im Page Editor. Das Ganze funktioniert auch Mehrsprachig.
[[ProcessWire - Functional Fields]]
https://processwire.com/blog/posts/functional-fields/
Beispiele für die Ausgabe von
<pre>
__text('your text');
__textarea('your text');
__richtext('<p>your text</p>');
__text('Subscribe Now', 'subscribe') // define a identifier for this text snippet...
__text('subscribe') // ..reuse it this way
$pages->get('/')->mytext->subscribe // reuse from another template
__text('Subscribe Now', 'subscribe', 'Submit button'); // Label for page editor
__text('Subscribe Now', 'subscribe', 'label=Submit button, notes=Test'); // or use a pw selector
__text('Subscribe Now', 'name=subscribe, label=Submit button, notes=Test'); // equivalent to upper

</pre>

=== Standard Multilanguage nach i18n ===

$out = $this->_("Live long and prosper"); // syntax within a class
$out = __("Live long and prosper!"); // syntax outside of a class

Dann im Backend unter der Sprache "Find files to translate" und die Template Datei auswählen.

=== Variablen in i18n ===
$out = sprintf(__("Created %d pages."), $count);
$out = sprintf(__('Your city is %1$s, and your zip code is %2$s.'), $city, $zipcode);

=== Plural in Multilanguage Files===
Hierzu gibt es die _n() Funktion
$out = sprintf(_n("Created %d page.", "Created %d pages.", $count), $count);
=== Unterschiedliche Übersetzungen bei gleichem Wortlaut ===
Manchmal muss der Begriff in anderen Sprachen unterschiedlich übersetzt werden, obwohl er in der Default Sprache gleich lautet:
<pre>
$label = _x('Comment', 'noun'); // or $this->_x('Comment', 'noun') in a class
...
// some other place in the code
echo _x('Comment', 'column name');
</pre>

=== Kommentare für den Übersetzer und User ===
$date = __('g:i:s a'); // Date string in PHP date() format
echo __("Welcome Guest"); // Headline for guest user // Keep it short (2-3 words)
=== Regeln ===
* Eine Zeile ein Paar Anführungszeichen
* Nur eine Übersetzungsfunktion pro Zeile

== Language Switcher ==
<syntaxhighlight lang="php">
// remember what language is set to
$savedLanguage = $user->language;

foreach($languages as $language) {

// if user is already viewing the page in this language, skip it
if($language->id == $savedLanguage->id) continue;

// if this page isn't viewable (active) for the language, skip it
if(!$page->viewable($language)) continue;

// set the user's language, so that the $page->url and any other
// fields we access from it will be reflective of the $language
$user->language = $language;

// output a link to this page in the other language
echo "<li><a href='$page->url'>$language->title: $page->title</a></li>";
}
// restore the original language setting
$user->language = $savedLanguage;
</syntaxhighlight>

== Seiten nur in einer Sprache verfügbar ==
What If I want to create/publish a page only in DE language, and that page should not be available in the default language?
Default language is required. But you could always add your own checkbox field to the page as a toggle to disable it. Your head.inc or _init.php or whatever your common initialization file is could check:

if($page->disable_default_language && $user->language->isDefault()) throw new Wire404Exception();
You'd also have to consider it with navigation generation, perhaps skipping over pages that have the toggle set while in the default language, or adding it to your selectors when querying pages.

Edit: you could also just choose to not use the default language at all.

if($user->language->isDefault()) $user->language = $languages->get("en-us"); // or whatever you want your default to be

== Language Alternate Fields ==
Eine Möglichkeit alle Felder (auch Bilder) in verschiedenen Sprachen zu nutzen.
https://processwire.com/docs/multi-language-support/multi-language-fields/#language-alternate-fields

== Probleme lösen ==
=== Feldtyp nicht als Multilanguagefeld vorhanden - Language Alternate Field ===
Manche Felder (z.B. AssistedUrl) gibt es nur einsprachig. ProcessWire bietet aber mit den '''Language Alternate Fields''' eine Möglichkeit solche Felder mehrsprachig zu nutzen. Dazu braucht man kein Modul. Es ist eine Basis Funktionalität.

Dazu legt man für jede zusätzliche Sprache ein weiteres Feld mit dem selben Namen + der Namenserweiterung _sprachname an. Beispielsweise kann man für ein Feld Namens link ein weiteres Feld Namens '''link_en''' anlegen. Dann nutzt ProcessWire automatisch für die Sprache mit dem Namen '''en'''

== Beispiele ==

=== Multilanguage Page - Quickstart ===

==== 1. Module ====
* s.o. alle benötigten installieren

==== 2. Backend ====
* Default Sprache festlegen
** Wenn nicht Englisch Sprachpaket installieren
** Wenn der Titel der Sprache auch der Identifier für den html Tag sein soll muss er ''de, en, fi''... lauten
* Weitere Sprachen hinzufügen. Für Englisch benötigt man kein Sprachpaket. Als Name am besten den offiziellen Code (de, en...) vergeben.
* Die Homepage entscheidet über den Pfad. Wenn Englisch z.B. unter www.meineSeite.com/en/seitenname/ erreichbar sein soll, dann muss für Englisch unter '''Einstellung > Namen en''' eingetragen werden.
* Alle Felder die Übersetzt werden sollen auf Multilanguage Felder umstellen

==== 3. Templates ====
===== Lang Attribute =====

Das '''lang Attribut''' sollte zur Sprache passen.

'''Möglichkeit 1:'''

Mit der _x Funktion kann PW beliebige Strings in Templates übersetzten. PW findet diese automatisch.
_main.php (oder header..)
<html lang="<?php echo _x('en', 'HTML language code'); ?>">
Im '''Backend''' muss man zunächst für Englisch den '''Sprachindex aufbauen''' ('''Spracheinstellungen Verwaltung > Sprachen > Englisch''')

Dann kann man nun in den '''Spracheinstellungen Verwaltung > Sprachen > meineSprache''' das Label ''HTML language code'' suchen und mit dem passenden lang tag ersetzen.

Das Funktioniert auch mit beliebigen anderen Werten die man im Template hartkodiert hat.

'''Möglichkeit 2:'''

Man kann auch den Language Title verwenden wenn dieser entsprechend vergeben wurde (en, de,...) .

'''Nachteil:''' Dann kann man aber den Titel nicht mehr frei verändern wenn man ihn auch als Bezeichnung für den Language Switcher nutezn möchte.
<html lang="<?= $user->language->title ?>">

'''Möglichkeit 3'''

Dies hat bei mir nicht funktioniert:
<pre>
<? $lang = $pages->get(1)->getLanguageValue($user->language, 'name'); ?>
<html lang="<?php echo $lang ?>">
</pre>
Hier wird einfach der Name der Sprache die der Benutzer im Moment hat (Session) ausgegeben. Der Name der Sprache sollte im Backend entsprechend der Norm gewählt sein. (de, it, fi...). Problem war das man den Namen der default Sprache nicht vergeben kann.

==== 4. Language Switcher ====
'''Text Navigation''' z.B. so:
<syntaxhighlight lang="php">
<?php namespace ProcessWire;

?>
<ul id="nav-lang" class="nav nav-h">
<?php
foreach($languages as $language){
if(!$page->viewable($language)) continue; // is page viewable in this language?
if($language->id == $user->language->id) {
echo "<li class='current'>";
} else {
echo "<li>";
}
$url = $page->localUrl($language);
$hreflang = $pages->get('/')->getLanguageValue($language, 'name');
echo '<a hreflang="'.$hreflang.'" href="'.$url.'" style="text-transform:uppercase;">'.$language->title.'</a></li>';
echo "</li>";
}
?>
</ul>
</syntaxhighlight>

=====Textnavigation mit first/last etc. Klassen=====

<syntaxhighlight lang="php">
<?php namespace ProcessWire;

?>
<ul id="nav-lang" class="nav nav-h">
<?php
$n = $languages->count();
$i = 0;

$separator = '<span class="separator">|</span>';
foreach($languages as $language){
$liClass = array();
if(!$page->viewable($language)) continue; // is page viewable in this language?
$i++;
if( $i == 1 ) $liClass[] = "first";
if( $i == $n ) $liClass[] = "last";
if($language->id == $user->language->id) $liClass[] = 'current';
echo '<li class="'.implode(' ',$liClass).'">';
$url = $page->localUrl($language);
$hreflang = $pages->get('/')->getLanguageValue($language, 'name');
echo '<a hreflang="'.$hreflang.'" href="'.$url.'" style="text-transform:uppercase;">'.$language->title.'</a></li>';
if( $i < $n ) echo $separator;
echo "</li>";
}
?>
</ul>
</syntaxhighlight>

=====Flaggennavi=====
z.B. so :
<syntaxhighlight lang="php">
<?php namespace ProcessWire;

?>
<ul id="nav-lang" class="">
<?php
foreach($languages as $language){
if(!$page->viewable($language)) continue; // is page viewable in this language?
if($language->id == $user->language->id) {

echo '<li class="current" style="opacity:0.5;">';
} else {
echo '<li>';
}
$flag = urls()->templates.'assets/flag-'.$language->name.'.png';
$url = $page->localUrl($language);
$hreflang = $pages->get('/')->getLanguageValue($language, 'name');
echo '<a hreflang="'.$hreflang.'" href="'.$url.'"><img class="flag" src="'.$flag.'" style="width: 100px;"></a></li>';
echo '</li>';
}
?>
</ul>
</syntaxhighlight>

===== Language Toggle Schiebeschalter =====
'''PHP-Script für schnelles erstellen eines Schiebeschalters'''
Bezieht sich auf das CSS für den fixed width Schalter
<syntaxhighlight lang="php">
<?php namespace ProcessWire;
/**
* langtoggle.inc
* User is en, show de toggle. User en, show de toggle
* Setze das title Feld der jeweiligen Sprache so wie du die Label haben möchtest
*
* Example SCSS:
* https://wiki.stephanschlegel.de/index.php?title=ProcessWire_-_Multilanguage_Website#4._Language_Switcher
*/

$langtoggle = '';
$user->language->name == 'en' ? $targetlangName = 'default' : $targetlangName = 'en'; //setzt voraus, das die name-Felder der Sprachen en und default sind. default ist immer der name der Standarssprache

foreach($languages as $language){
if(!$page->viewable($language)) continue;
if($language->id == $user->language->id) {
// button für diese Sprache wird nicht benötigt
// du könntest hier auch eine gedimmte Version nehmen
}else{
// URL der aktuellen Seite für die Zielsprache
$url = $page->localUrl($language);
//bd($url, 'langtoggle: target url');

$langtoggle .= '
<div class="language-switcher-fixed">
<a href="'.$url.'" class="toggle-switch '.$language->name.'" title="'.$language->title.'">
<div class="switch">
<div class="knob"></div>
<div class="label">'.$language->title.'</div>
</div>
</a>
</div>
';
}
}
?>
</syntaxhighlight>

'''CSS für fixed width Schiebeschalter mit Parametern'''
<syntaxhighlight lang="scss">
// Toggle Params
$switch-background-color :#006B52;
$switch-background-color-hover: #4a9a14;
$switch-label-color: #fff;
$switch-border-color: rgba(255, 255, 255, 0.642
);
$knob-color: #006B52;
$knob-border-color: transparent;
$knob-background-color: #fff;
$switch-width: 60px; // change this
$switch-border-thickness: 2px; // change this
$knob-gap: 5px; // change this (distance to border)
$switch-outer-width: $switch-width + 2 * $switch-border-thickness; // compensate border space
$switch-height: floor(($switch-width + 2 * $switch-border-thickness) / 2);
$switch-border-radius: ceil($switch-height / 2 + 2 * $switch-border-thickness);
$switch-label-font-size: floor($switch-height / 2);
$switch-label-width: floor($switch-width / 2);
$switch-label-distance: floor($switch-border-radius / 3);
$knob-height: (
floor($switch-width / 2) - ((2 * $knob-gap) + 2px)
);
$knob-width: $knob-height;

/* fixed width */

.language-switcher-fixed {
// display: flex;
// gap: 1rem;

.toggle-switch {
text-decoration: none;
display: inline-block;

.switch {
position: relative;
width: $switch-outer-width;
height: $switch-height;
background-color: $switch-background-color;
border-radius: $switch-border-radius;
border: $switch-border-thickness solid $switch-border-color;
transition: background-color 0.3s ease;
}

.knob {
position: absolute;
top: $knob-gap;
width: $knob-width;
height: $knob-height;
background-color: $knob-background-color;
border-radius: 50%;
border: $switch-border-thickness solid $knob-border-color;
transition: all 0.3s ease;
}

.label {
position: absolute;
top: 50%;
transform: translateY(-50%);
font-size: $switch-label-font-size;
font-weight: bold;
text-transform: uppercase;
color: $switch-label-color;
width: $switch-label-width;
text-align: center;
}
}

/* Default Schalter: Knopf links, Beschriftung rechts */
.toggle-switch.default {
.knob {
left: $knob-gap;
}

.label {
right: $switch-label-distance;
}
}

/* Englischer Schalter: Knopf rechts, Beschriftung links */
.toggle-switch.en {
.knob {
right: $knob-gap;
}

.label {
left: $switch-label-distance;
}
}

/* Hover- und Active-Effekte */
.toggle-switch:hover .switch {
background-color: $switch-background-color-hover;
}

.toggle-switch:active .knob {
transform: scale(0.95);
}

}
</syntaxhighlight>

''' Allgemeiner code (Beispiel mit dynamischer Breite enthalten '''
Siehe auch Codepen "Kholja"
<syntaxhighlight lang="html5">
<h2>Fixed width label</h2>

<div class="language-switcher-fixed">

<a href="/en" class="toggle-switch en" title="Wechsel zu Englisch">
<div class="switch">
<div class="knob"></div>
<div class="label">en</div>
</div>
</a>


<a href="/de" class="toggle-switch de" title="Wechsel zu Deutsch">
<div class="switch">
<div class="knob"></div>
<div class="label">de</div>
</div>
</a>
</div>

<h2>Dynamic width label</h2>
<div class="language-switcher-dynamic">

<a href="/de" class="toggle-switch de" title="Wechsel zu Deutsch">
<div class="switch">
<div class="knob"></div>
<span class="label">Deutsch</span>
</div>
</a>


<a href="/en" class="toggle-switch en" title="Wechsel zu Englisch">
<div class="switch">
<div class="knob"></div>
<span class="label">English</span>
</div>
</a>
</div>
</syntaxhighlight>

<syntaxhighlight lang="scss">
// Toggle Params
$switch-background-color :#006B52;
$switch-background-color-hover: #4a9a14;
$switch-label-color: #fff;
$switch-border-color: rgba(255, 255, 255, 0.642
);
$knob-color: #006B52;
$knob-border-color: transparent;
$knob-background-color: #fff;
$switch-width: 60px; // change this
$switch-border-thickness: 2px; // change this
$knob-gap: 5px; // change this (distance to border)
$switch-outer-width: $switch-width + 2 * $switch-border-thickness; // compensate border space
$switch-height: floor(($switch-width + 2 * $switch-border-thickness) / 2);
$switch-border-radius: ceil($switch-height / 2 + 2 * $switch-border-thickness);
$switch-label-font-size: floor($switch-height / 2);
$switch-label-width: floor($switch-width / 2);
$switch-label-distance: floor($switch-border-radius / 3);
$knob-height: (
floor($switch-width / 2) - ((2 * $knob-gap) + 2px)
);
$knob-width: $knob-height;

/* fixed width */

.language-switcher-fixed {
// display: flex;
// gap: 1rem;

.toggle-switch {
text-decoration: none;
display: inline-block;

.switch {
position: relative;
width: $switch-outer-width;
height: $switch-height;
background-color: $switch-background-color;
border-radius: $switch-border-radius;
border: $switch-border-thickness solid $switch-border-color;
transition: background-color 0.3s ease;
}

.knob {
position: absolute;
top: $knob-gap;
width: $knob-width;
height: $knob-height;
background-color: $knob-background-color;
border-radius: 50%;
border: $switch-border-thickness solid $knob-border-color;
transition: all 0.3s ease;
}

.label {
position: absolute;
top: 50%;
transform: translateY(-50%);
font-size: $switch-label-font-size;
font-weight: bold;
text-transform: uppercase;
color: $switch-label-color;
width: $switch-label-width;
text-align: center;
}
}

/* Default Schalter: Knopf links, Beschriftung rechts */
.toggle-switch.default {
.knob {
left: $knob-gap;
}

.label {
right: $switch-label-distance;
}
}

/* Englischer Schalter: Knopf rechts, Beschriftung links */
.toggle-switch.en {
.knob {
right: $knob-gap;
}

.label {
left: $switch-label-distance;
}
}

/* Hover- und Active-Effekte */
.toggle-switch:hover .switch {
background-color: $switch-background-color-hover;
}

.toggle-switch:active .knob {
transform: scale(0.95);
}

}
</syntaxhighlight>

=== Prantner ===
Hauptnavigation mit Flaggen:

language-switcher.inc
<syntaxhighlight lang="php">
<?php namespace ProcessWire;
$imgMarkup = "";
$out = "";
foreach($languages as $language) {
if(!$page->viewable($language)) continue; // is page viewable in this language?
$url = $page->localUrl($language);
$hreflang = $homepage->getLanguageValue($language, 'name');
$imgUrl = $config->urls->templates.'assets/flags/'.$language->name.'_sq.png';
$imgMarkup = "<img src=\"$imgUrl\" title=\"$language->title\" alt=\"$language->title\" class=\"circle z-depth-1\">";
if($language->id == $user->language->id) {
$out .= "<span class=\"lang-button current\">";
} else {
$out .= "<span class=\"lang-button\">";
}
$out .= "<a hreflang=\"$hreflang\" href=\"$url\">$imgMarkup</a></span>";
}
$out = '<div id="nav-lang">'.$out.'</div>';
echo $out;
?>
</syntaxhighlight>

language-switcher-mobile.inc
<syntaxhighlight lang="php">
<?php namespace ProcessWire;
?>
<ul id="nav-mobile" class="right hide-on-med-and-down">
<?php
foreach($languages as $language) {
if(!$page->viewable($language)) continue; // is page viewable in this language?
if($language->id == $user->language->id) {
echo "<li class='current'>";
} else {
echo "<li>";
}
$url = $page->localUrl($language);
$hreflang = $homepage->getLanguageValue($language, 'name');
echo "<a hreflang='$hreflang' href='$url'>$language->title</a></li>";
}
?>
</ul>
</syntaxhighlight>

== Language Snippets ==
=== URL der Sprache ===
$language = $user->language;
$page->getLanguageValue($language->id, 'url'); // getLanguageValue kann auf verschiedene Werte des language Objekts zugreifen hier auf die 'url' z.B. "/" bei Homepage oder "/en/"
$page->localUrl($language->id); // Kurzform von oberem Beispiel
$page->localHttpUrl($language->id); // Absolute URL z.B. 'https://100.dekra-online.de/en/'

=== Field Label in aktueller Sprache ===
fields($f)->getLabel()
Wobei $f ein Feldname sein kann aber auch ein Feldobjekt.

ProcessWire - Multilanguage Website

2025-03-22T10:07:14Z

109.193.152.88: /* URL der Sprache */

Mehrsprachige Websites mit ProcessWire / Andere Default Sprache

== Links ==
* https://processwire.com/docs/multi-language-support/
* https://processwire.com/talk/topic/5518-multi-language-site/
* http://processwire.com/api/multi-language-support/multi-language-urls/
* https://processwire.com/talk/topic/9322-change-default-language-for-homepage/ (Modul Solution, mehr zur Anschauung)

== Einleitung ==
Es gibt mehrere Bereiche an die man denken muss. Einmal geht es um die Eingabe im Backend, die Ausgabe im Frontend, die Sprachnavigation auf der Website und die Templates:
* Wie übersetze ich Text in meinen '''Templates''' ? Siehe unten i18n
* Wie übersetze ich '''Inhalte''' im Backend ? Dafür ist das Modul Language Support Fields zuständig
* Wie sollen meine URLs aussehen ? Prinzipiell kann man jedem User unterschiedliche Sprachen auch ohne andere Domain liefern (über seine Session) aber i.d.R wollen wir die URL anzupassen.
** ''domain.de/en/meineSeite'' oder ''domain.de/myPage''
** Um '''Seitennamen''' zu übersetzen oder ein Domainkürzel in der URL voranzustellen benötige ich das Modul '''Language Support Page Names'''

== Welche Module benötige ich ==
Da es einige Module in diesem Zusammenhang gibt hier eine Übersicht. Man findet Sie am besten unter
Modules > Core > Language

* '''Languages Support''' - ProcessWire multi-language support. Basis Modul bracht man für alle Beispiele unten. Reicht aus, wenn man nur die Standard-Sprache ändern will. '''Hinweis:''' In der aktuellen PW3 Version schlägt einem ProcessWire nach Installation des Language Support Moduls gleich die Ergänzenden Module (s.u.) vor und man kann den Installationsprozess ziemlich fix erledigen.
* '''Languages Support - Fields''' Required to use multi-language fields. Basis für mehrsprachige Felder im Backend.
* '''Languages Support - Page Names''' (LanguageSupportPageNames) Required to use multi-language page names. Braucht man nur wenn '''alle Seiten in allen Sprachen unterschiedliche Namen''' bekommen sollen.
* '''Languages Support - Tabs''' Organizes multi-language fields into tabs for a cleaner easier to use interface.
Für mehrsprachige Seiten benötigen wir im Frontend i.d.R. folgende Module:
* '''Language Support Fields''' - Sind Felder, die im Backend für jede Sprache eine eigene Eingabe bieten.
* '''Language Support Page Names''' benötigt man, damit man für die Sprachen eigene URLs angeben kann. Z.B. bei Home in Englisch /en/ usw.
* '''FieldtypePageTitleLanguage''' benötigt man wenn man alle Seitenamen anpassen will (seite1_de seite1_fr ...) Für einen reinen Sprachpfad (/de/Seite) braucht man das nicht.

== Einsprachige Seite aber Deutsch als Default Sprache ==
Wenn nur die Standardsprache verändern möchte, aber keine Mehrsprachige Seite benötigt brauchen wir nur das Modul '''Language Support'''
* Enable languages support -> '''Core Module "Language Support" aktivieren'''. -> Sprachen stehen num im Backend Setup zur Verfügung
* '''Titel der Default Sprache''' anpassen (z.B. Deutsch (default) )
* Language Pack in der default Sprache installieren -> Dies ist ab jetzt die Default Sprache. Nicht vergessen auch den '''lang Tag im Header''' zu setzen, damit der Browser die Sprache richtig erkennt.

== Sprachpakete installieren ==
https://processwire.com/modules/category/language-pack/
* Sprache auswählen und dort komplettes zip hochladen.
* Informell (DU) leider im Moment nicht vorhanden

== Basis-Module für Mehrsprachigkeit im Backend ==
Für mehrsprachige Seiten benötigen wir i.d.R. folgende Module:
* '''Language Support Fields''' für die Backend Übersetzungen und '''Language Support Page Names''' für die URLs.
* '''FieldtypePageTitleLanguage''' benötigt man wenn man alle Seitenamen anpassen will (seite1_de seite1_fr ...) Für einen reinen Sprachpfad (/de/Seite) braucht man das nicht.
* Für weitere Sprachen entsprechend hinzufügen.
Vorgehen:
* Language Packs installieren: drop in the none english language pack (for admin backend) into the default language, (e.g. german langpack)
* As a nice sideeffect every new user in your system gets the native language per default without have it to select from the list.

== Templates für Multilanguage vorbereiten (i18n) ==
https://processwire.com/docs/multi-language-support/code-i18n/
https://processwire.com/blog/posts/functional-fields/
=== Functional fields ===
In PW3 kamen die functional Fields hinzu. Mit diesen kann man statischen Text dynamisch im Page Editor ansprechen. D.h. das Functional Field findet Texte im Template und macht sie automatisch editierbar im Page Editor. Das Ganze funktioniert auch Mehrsprachig.
[[ProcessWire - Functional Fields]]
https://processwire.com/blog/posts/functional-fields/
Beispiele für die Ausgabe von
<pre>
__text('your text');
__textarea('your text');
__richtext('<p>your text</p>');
__text('Subscribe Now', 'subscribe') // define a identifier for this text snippet...
__text('subscribe') // ..reuse it this way
$pages->get('/')->mytext->subscribe // reuse from another template
__text('Subscribe Now', 'subscribe', 'Submit button'); // Label for page editor
__text('Subscribe Now', 'subscribe', 'label=Submit button, notes=Test'); // or use a pw selector
__text('Subscribe Now', 'name=subscribe, label=Submit button, notes=Test'); // equivalent to upper

</pre>

=== Standard Multilanguage nach i18n ===

$out = $this->_("Live long and prosper"); // syntax within a class
$out = __("Live long and prosper!"); // syntax outside of a class

Dann im Backend unter der Sprache "Find files to translate" und die Template Datei auswählen.

=== Variablen in i18n ===
$out = sprintf(__("Created %d pages."), $count);
$out = sprintf(__('Your city is %1$s, and your zip code is %2$s.'), $city, $zipcode);

=== Plural in Multilanguage Files===
Hierzu gibt es die _n() Funktion
$out = sprintf(_n("Created %d page.", "Created %d pages.", $count), $count);
=== Unterschiedliche Übersetzungen bei gleichem Wortlaut ===
Manchmal muss der Begriff in anderen Sprachen unterschiedlich übersetzt werden, obwohl er in der Default Sprache gleich lautet:
<pre>
$label = _x('Comment', 'noun'); // or $this->_x('Comment', 'noun') in a class
...
// some other place in the code
echo _x('Comment', 'column name');
</pre>

=== Kommentare für den Übersetzer und User ===
$date = __('g:i:s a'); // Date string in PHP date() format
echo __("Welcome Guest"); // Headline for guest user // Keep it short (2-3 words)
=== Regeln ===
* Eine Zeile ein Paar Anführungszeichen
* Nur eine Übersetzungsfunktion pro Zeile

== Language Switcher ==
<syntaxhighlight lang="php">
// remember what language is set to
$savedLanguage = $user->language;

foreach($languages as $language) {

// if user is already viewing the page in this language, skip it
if($language->id == $savedLanguage->id) continue;

// if this page isn't viewable (active) for the language, skip it
if(!$page->viewable($language)) continue;

// set the user's language, so that the $page->url and any other
// fields we access from it will be reflective of the $language
$user->language = $language;

// output a link to this page in the other language
echo "<li><a href='$page->url'>$language->title: $page->title</a></li>";
}
// restore the original language setting
$user->language = $savedLanguage;
</syntaxhighlight>

== Seiten nur in einer Sprache verfügbar ==
What If I want to create/publish a page only in DE language, and that page should not be available in the default language?
Default language is required. But you could always add your own checkbox field to the page as a toggle to disable it. Your head.inc or _init.php or whatever your common initialization file is could check:

if($page->disable_default_language && $user->language->isDefault()) throw new Wire404Exception();
You'd also have to consider it with navigation generation, perhaps skipping over pages that have the toggle set while in the default language, or adding it to your selectors when querying pages.

Edit: you could also just choose to not use the default language at all.

if($user->language->isDefault()) $user->language = $languages->get("en-us"); // or whatever you want your default to be

== Language Alternate Fields ==
Eine Möglichkeit alle Felder (auch Bilder) in verschiedenen Sprachen zu nutzen.
https://processwire.com/docs/multi-language-support/multi-language-fields/#language-alternate-fields

== Probleme lösen ==
=== Feldtyp nicht als Multilanguagefeld vorhanden - Language Alternate Field ===
Manche Felder (z.B. AssistedUrl) gibt es nur einsprachig. ProcessWire bietet aber mit den '''Language Alternate Fields''' eine Möglichkeit solche Felder mehrsprachig zu nutzen. Dazu braucht man kein Modul. Es ist eine Basis Funktionalität.

Dazu legt man für jede zusätzliche Sprache ein weiteres Feld mit dem selben Namen + der Namenserweiterung _sprachname an. Beispielsweise kann man für ein Feld Namens link ein weiteres Feld Namens '''link_en''' anlegen. Dann nutzt ProcessWire automatisch für die Sprache mit dem Namen '''en'''

== Beispiele ==

=== Multilanguage Page - Quickstart ===

==== 1. Module ====
* s.o. alle benötigten installieren

==== 2. Backend ====
* Default Sprache festlegen
** Wenn nicht Englisch Sprachpaket installieren
** Wenn der Titel der Sprache auch der Identifier für den html Tag sein soll muss er ''de, en, fi''... lauten
* Weitere Sprachen hinzufügen. Für Englisch benötigt man kein Sprachpaket. Als Name am besten den offiziellen Code (de, en...) vergeben.
* Die Homepage entscheidet über den Pfad. Wenn Englisch z.B. unter www.meineSeite.com/en/seitenname/ erreichbar sein soll, dann muss für Englisch unter '''Einstellung > Namen en''' eingetragen werden.
* Alle Felder die Übersetzt werden sollen auf Multilanguage Felder umstellen

==== 3. Templates ====
===== Lang Attribute =====

Das '''lang Attribut''' sollte zur Sprache passen.

'''Möglichkeit 1:'''

Mit der _x Funktion kann PW beliebige Strings in Templates übersetzten. PW findet diese automatisch.
_main.php (oder header..)
<html lang="<?php echo _x('en', 'HTML language code'); ?>">
Im '''Backend''' muss man zunächst für Englisch den '''Sprachindex aufbauen''' ('''Spracheinstellungen Verwaltung > Sprachen > Englisch''')

Dann kann man nun in den '''Spracheinstellungen Verwaltung > Sprachen > meineSprache''' das Label ''HTML language code'' suchen und mit dem passenden lang tag ersetzen.

Das Funktioniert auch mit beliebigen anderen Werten die man im Template hartkodiert hat.

'''Möglichkeit 2:'''

Man kann auch den Language Title verwenden wenn dieser entsprechend vergeben wurde (en, de,...) .

'''Nachteil:''' Dann kann man aber den Titel nicht mehr frei verändern wenn man ihn auch als Bezeichnung für den Language Switcher nutezn möchte.
<html lang="<?= $user->language->title ?>">

'''Möglichkeit 3'''

Dies hat bei mir nicht funktioniert:
<pre>
<? $lang = $pages->get(1)->getLanguageValue($user->language, 'name'); ?>
<html lang="<?php echo $lang ?>">
</pre>
Hier wird einfach der Name der Sprache die der Benutzer im Moment hat (Session) ausgegeben. Der Name der Sprache sollte im Backend entsprechend der Norm gewählt sein. (de, it, fi...). Problem war das man den Namen der default Sprache nicht vergeben kann.

==== 4. Language Switcher ====
'''Text Navigation''' z.B. so:
<syntaxhighlight lang="php">
<?php namespace ProcessWire;

?>
<ul id="nav-lang" class="nav nav-h">
<?php
foreach($languages as $language){
if(!$page->viewable($language)) continue; // is page viewable in this language?
if($language->id == $user->language->id) {
echo "<li class='current'>";
} else {
echo "<li>";
}
$url = $page->localUrl($language);
$hreflang = $pages->get('/')->getLanguageValue($language, 'name');
echo '<a hreflang="'.$hreflang.'" href="'.$url.'" style="text-transform:uppercase;">'.$language->title.'</a></li>';
echo "</li>";
}
?>
</ul>
</syntaxhighlight>

=====Textnavigation mit first/last etc. Klassen=====

<syntaxhighlight lang="php">
<?php namespace ProcessWire;

?>
<ul id="nav-lang" class="nav nav-h">
<?php
$n = $languages->count();
$i = 0;

$separator = '<span class="separator">|</span>';
foreach($languages as $language){
$liClass = array();
if(!$page->viewable($language)) continue; // is page viewable in this language?
$i++;
if( $i == 1 ) $liClass[] = "first";
if( $i == $n ) $liClass[] = "last";
if($language->id == $user->language->id) $liClass[] = 'current';
echo '<li class="'.implode(' ',$liClass).'">';
$url = $page->localUrl($language);
$hreflang = $pages->get('/')->getLanguageValue($language, 'name');
echo '<a hreflang="'.$hreflang.'" href="'.$url.'" style="text-transform:uppercase;">'.$language->title.'</a></li>';
if( $i < $n ) echo $separator;
echo "</li>";
}
?>
</ul>
</syntaxhighlight>

=====Flaggennavi=====
z.B. so :
<syntaxhighlight lang="php">
<?php namespace ProcessWire;

?>
<ul id="nav-lang" class="">
<?php
foreach($languages as $language){
if(!$page->viewable($language)) continue; // is page viewable in this language?
if($language->id == $user->language->id) {

echo '<li class="current" style="opacity:0.5;">';
} else {
echo '<li>';
}
$flag = urls()->templates.'assets/flag-'.$language->name.'.png';
$url = $page->localUrl($language);
$hreflang = $pages->get('/')->getLanguageValue($language, 'name');
echo '<a hreflang="'.$hreflang.'" href="'.$url.'"><img class="flag" src="'.$flag.'" style="width: 100px;"></a></li>';
echo '</li>';
}
?>
</ul>
</syntaxhighlight>

===== Language Toggle Schiebeschalter =====
Siehe auch Codepen "Kholja"
<syntaxhighlight lang="html5">
<h2>Fixed width label</h2>

<div class="language-switcher-fixed">

<a href="/en" class="toggle-switch en" title="Wechsel zu Englisch">
<div class="switch">
<div class="knob"></div>
<div class="label">en</div>
</div>
</a>


<a href="/de" class="toggle-switch de" title="Wechsel zu Deutsch">
<div class="switch">
<div class="knob"></div>
<div class="label">de</div>
</div>
</a>
</div>

<h2>Dynamic width label</h2>
<div class="language-switcher-dynamic">

<a href="/de" class="toggle-switch de" title="Wechsel zu Deutsch">
<div class="switch">
<div class="knob"></div>
<span class="label">Deutsch</span>
</div>
</a>


<a href="/en" class="toggle-switch en" title="Wechsel zu Englisch">
<div class="switch">
<div class="knob"></div>
<span class="label">English</span>
</div>
</a>
</div>
</syntaxhighlight>

<syntaxhighlight lang="scss">
$switch-background-color :#006B52;
$switch-background-color-hover: #4a9a14;
$label-color: #fff;
// $border-color: rgba(0,0,0,0.5);
$switch-border-color: #fff;
$knob-color: #006B52;
// $knob-border-color: rgba(0,0,0,0.5);
$knob-border-color: transparent;
$knob-background-color: #fff;
body{
font-family: Helvetica, sans-serif;
background: #006B52;
color: white;
}
h2{
text-align: center;
}
.language-switcher-fixed, .language-switcher-dynamic{
padding: 40px;
justify-content: center;
}
/* fixed width */
.language-switcher-fixed {
display: flex;
gap: 1rem;

.toggle-switch {
text-decoration: none;
display: inline-block;

.switch {
position: relative;
width: 64px;
height: 32px;
background-color: $switch-background-color;
border-radius: 16px;
border: 1px solid $switch-border-color;
transition: background-color 0.3s ease;
}

.knob {
position: absolute;
top: 3px;
width: 24px;
height: 24px;
background-color: $knob-background-color;
border-radius: 50%;
border: 1px solid $knob-border-color;
transition: all 0.3s ease;
}

.label {
position: absolute;
top: 50%;
transform: translateY(-50%);
font-size: 15px;
font-weight: bold;
text-transform: uppercase;
color: $label-color;
}
}

/* Deutscher Schalter: Knopf links, Beschriftung rechts */
.toggle-switch.de {
.knob {
left: 2px;
}
.label {
right: 8px;
}
}

/* Englischer Schalter: Knopf rechts, Beschriftung links */
.toggle-switch.en {
.knob {
right: 2px;
}
.label {
left: 8px;
}
}

/* Hover- und Active-Effekte */
.toggle-switch:hover .switch {
background-color: $switch-background-color-hover;
}
.toggle-switch:active .knob {
transform: scale(0.95);
}

}

/* dynamic width */
.language-switcher-dynamic {
display: flex;
gap: 1rem;
.toggle-switch {
text-decoration: none;
display: inline-block;

.switch {
display: inline-flex;
align-items: center;
border-radius: 21px;
border: 1px solid $switch-border-color;
background-color: $switch-background-color;
padding: 5px 10px;
transition: background-color 0.3s ease;
/* Die Breite passt sich automatisch an den Inhalt an */
}

.knob {
width: 26px;
height: 26px;
background-color: $knob-background-color;
border-radius: 50%;
box-shadow: 0 1px 3px rgba(0, 0, 0, 0.3);
transition: transform 0.3s ease;
flex-shrink: 0;
}

.label {
font-size: 0.9rem;
font-weight: bold;
color: $label-color;
margin: 0 5px;
text-transform: uppercase;
}
}

/* Deutscher Schalter: Knopf links, Label rechts */
.toggle-switch.de .switch {
flex-direction: row;
}

/* Englischer Schalter: Knopf rechts, Label links */
.toggle-switch.en .switch {
flex-direction: row-reverse;
}

/* Hover- und Active-Effekte */
.toggle-switch:hover .switch {
background-color: $switch-background-color-hover;
}

.toggle-switch:active .knob {
transform: scale(0.95);
}

}

</syntaxhighlight>

=== Prantner ===
Hauptnavigation mit Flaggen:

language-switcher.inc
<syntaxhighlight lang="php">
<?php namespace ProcessWire;
$imgMarkup = "";
$out = "";
foreach($languages as $language) {
if(!$page->viewable($language)) continue; // is page viewable in this language?
$url = $page->localUrl($language);
$hreflang = $homepage->getLanguageValue($language, 'name');
$imgUrl = $config->urls->templates.'assets/flags/'.$language->name.'_sq.png';
$imgMarkup = "<img src=\"$imgUrl\" title=\"$language->title\" alt=\"$language->title\" class=\"circle z-depth-1\">";
if($language->id == $user->language->id) {
$out .= "<span class=\"lang-button current\">";
} else {
$out .= "<span class=\"lang-button\">";
}
$out .= "<a hreflang=\"$hreflang\" href=\"$url\">$imgMarkup</a></span>";
}
$out = '<div id="nav-lang">'.$out.'</div>';
echo $out;
?>
</syntaxhighlight>

language-switcher-mobile.inc
<syntaxhighlight lang="php">
<?php namespace ProcessWire;
?>
<ul id="nav-mobile" class="right hide-on-med-and-down">
<?php
foreach($languages as $language) {
if(!$page->viewable($language)) continue; // is page viewable in this language?
if($language->id == $user->language->id) {
echo "<li class='current'>";
} else {
echo "<li>";
}
$url = $page->localUrl($language);
$hreflang = $homepage->getLanguageValue($language, 'name');
echo "<a hreflang='$hreflang' href='$url'>$language->title</a></li>";
}
?>
</ul>
</syntaxhighlight>

== Language Snippets ==
=== URL der Sprache ===
$language = $user->language;
$page->getLanguageValue($language->id, 'url'); // getLanguageValue kann auf verschiedene Werte des language Objekts zugreifen hier auf die 'url' z.B. "/" bei Homepage oder "/en/"
$page->localUrl($language->id); // Kurzform von oberem Beispiel
$page->localHttpUrl($language->id); // Absolute URL z.B. 'https://100.dekra-online.de/en/'

=== Field Label in aktueller Sprache ===
fields($f)->getLabel()
Wobei $f ein Feldname sein kann aber auch ein Feldobjekt.

ProcessWire - Multilanguage Website

2025-03-22T09:44:15Z

109.193.152.88: /* Language Toggle Schiebeschalter */

Mehrsprachige Websites mit ProcessWire / Andere Default Sprache

== Links ==
* https://processwire.com/docs/multi-language-support/
* https://processwire.com/talk/topic/5518-multi-language-site/
* http://processwire.com/api/multi-language-support/multi-language-urls/
* https://processwire.com/talk/topic/9322-change-default-language-for-homepage/ (Modul Solution, mehr zur Anschauung)

== Einleitung ==
Es gibt mehrere Bereiche an die man denken muss. Einmal geht es um die Eingabe im Backend, die Ausgabe im Frontend, die Sprachnavigation auf der Website und die Templates:
* Wie übersetze ich Text in meinen '''Templates''' ? Siehe unten i18n
* Wie übersetze ich '''Inhalte''' im Backend ? Dafür ist das Modul Language Support Fields zuständig
* Wie sollen meine URLs aussehen ? Prinzipiell kann man jedem User unterschiedliche Sprachen auch ohne andere Domain liefern (über seine Session) aber i.d.R wollen wir die URL anzupassen.
** ''domain.de/en/meineSeite'' oder ''domain.de/myPage''
** Um '''Seitennamen''' zu übersetzen oder ein Domainkürzel in der URL voranzustellen benötige ich das Modul '''Language Support Page Names'''

== Welche Module benötige ich ==
Da es einige Module in diesem Zusammenhang gibt hier eine Übersicht. Man findet Sie am besten unter
Modules > Core > Language

* '''Languages Support''' - ProcessWire multi-language support. Basis Modul bracht man für alle Beispiele unten. Reicht aus, wenn man nur die Standard-Sprache ändern will. '''Hinweis:''' In der aktuellen PW3 Version schlägt einem ProcessWire nach Installation des Language Support Moduls gleich die Ergänzenden Module (s.u.) vor und man kann den Installationsprozess ziemlich fix erledigen.
* '''Languages Support - Fields''' Required to use multi-language fields. Basis für mehrsprachige Felder im Backend.
* '''Languages Support - Page Names''' (LanguageSupportPageNames) Required to use multi-language page names. Braucht man nur wenn '''alle Seiten in allen Sprachen unterschiedliche Namen''' bekommen sollen.
* '''Languages Support - Tabs''' Organizes multi-language fields into tabs for a cleaner easier to use interface.
Für mehrsprachige Seiten benötigen wir im Frontend i.d.R. folgende Module:
* '''Language Support Fields''' - Sind Felder, die im Backend für jede Sprache eine eigene Eingabe bieten.
* '''Language Support Page Names''' benötigt man, damit man für die Sprachen eigene URLs angeben kann. Z.B. bei Home in Englisch /en/ usw.
* '''FieldtypePageTitleLanguage''' benötigt man wenn man alle Seitenamen anpassen will (seite1_de seite1_fr ...) Für einen reinen Sprachpfad (/de/Seite) braucht man das nicht.

== Einsprachige Seite aber Deutsch als Default Sprache ==
Wenn nur die Standardsprache verändern möchte, aber keine Mehrsprachige Seite benötigt brauchen wir nur das Modul '''Language Support'''
* Enable languages support -> '''Core Module "Language Support" aktivieren'''. -> Sprachen stehen num im Backend Setup zur Verfügung
* '''Titel der Default Sprache''' anpassen (z.B. Deutsch (default) )
* Language Pack in der default Sprache installieren -> Dies ist ab jetzt die Default Sprache. Nicht vergessen auch den '''lang Tag im Header''' zu setzen, damit der Browser die Sprache richtig erkennt.

== Sprachpakete installieren ==
https://processwire.com/modules/category/language-pack/
* Sprache auswählen und dort komplettes zip hochladen.
* Informell (DU) leider im Moment nicht vorhanden

== Basis-Module für Mehrsprachigkeit im Backend ==
Für mehrsprachige Seiten benötigen wir i.d.R. folgende Module:
* '''Language Support Fields''' für die Backend Übersetzungen und '''Language Support Page Names''' für die URLs.
* '''FieldtypePageTitleLanguage''' benötigt man wenn man alle Seitenamen anpassen will (seite1_de seite1_fr ...) Für einen reinen Sprachpfad (/de/Seite) braucht man das nicht.
* Für weitere Sprachen entsprechend hinzufügen.
Vorgehen:
* Language Packs installieren: drop in the none english language pack (for admin backend) into the default language, (e.g. german langpack)
* As a nice sideeffect every new user in your system gets the native language per default without have it to select from the list.

== Templates für Multilanguage vorbereiten (i18n) ==
https://processwire.com/docs/multi-language-support/code-i18n/
https://processwire.com/blog/posts/functional-fields/
=== Functional fields ===
In PW3 kamen die functional Fields hinzu. Mit diesen kann man statischen Text dynamisch im Page Editor ansprechen. D.h. das Functional Field findet Texte im Template und macht sie automatisch editierbar im Page Editor. Das Ganze funktioniert auch Mehrsprachig.
[[ProcessWire - Functional Fields]]
https://processwire.com/blog/posts/functional-fields/
Beispiele für die Ausgabe von
<pre>
__text('your text');
__textarea('your text');
__richtext('<p>your text</p>');
__text('Subscribe Now', 'subscribe') // define a identifier for this text snippet...
__text('subscribe') // ..reuse it this way
$pages->get('/')->mytext->subscribe // reuse from another template
__text('Subscribe Now', 'subscribe', 'Submit button'); // Label for page editor
__text('Subscribe Now', 'subscribe', 'label=Submit button, notes=Test'); // or use a pw selector
__text('Subscribe Now', 'name=subscribe, label=Submit button, notes=Test'); // equivalent to upper

</pre>

=== Standard Multilanguage nach i18n ===

$out = $this->_("Live long and prosper"); // syntax within a class
$out = __("Live long and prosper!"); // syntax outside of a class

Dann im Backend unter der Sprache "Find files to translate" und die Template Datei auswählen.

=== Variablen in i18n ===
$out = sprintf(__("Created %d pages."), $count);
$out = sprintf(__('Your city is %1$s, and your zip code is %2$s.'), $city, $zipcode);

=== Plural in Multilanguage Files===
Hierzu gibt es die _n() Funktion
$out = sprintf(_n("Created %d page.", "Created %d pages.", $count), $count);
=== Unterschiedliche Übersetzungen bei gleichem Wortlaut ===
Manchmal muss der Begriff in anderen Sprachen unterschiedlich übersetzt werden, obwohl er in der Default Sprache gleich lautet:
<pre>
$label = _x('Comment', 'noun'); // or $this->_x('Comment', 'noun') in a class
...
// some other place in the code
echo _x('Comment', 'column name');
</pre>

=== Kommentare für den Übersetzer und User ===
$date = __('g:i:s a'); // Date string in PHP date() format
echo __("Welcome Guest"); // Headline for guest user // Keep it short (2-3 words)
=== Regeln ===
* Eine Zeile ein Paar Anführungszeichen
* Nur eine Übersetzungsfunktion pro Zeile

== Language Switcher ==
<syntaxhighlight lang="php">
// remember what language is set to
$savedLanguage = $user->language;

foreach($languages as $language) {

// if user is already viewing the page in this language, skip it
if($language->id == $savedLanguage->id) continue;

// if this page isn't viewable (active) for the language, skip it
if(!$page->viewable($language)) continue;

// set the user's language, so that the $page->url and any other
// fields we access from it will be reflective of the $language
$user->language = $language;

// output a link to this page in the other language
echo "<li><a href='$page->url'>$language->title: $page->title</a></li>";
}
// restore the original language setting
$user->language = $savedLanguage;
</syntaxhighlight>

== Seiten nur in einer Sprache verfügbar ==
What If I want to create/publish a page only in DE language, and that page should not be available in the default language?
Default language is required. But you could always add your own checkbox field to the page as a toggle to disable it. Your head.inc or _init.php or whatever your common initialization file is could check:

if($page->disable_default_language && $user->language->isDefault()) throw new Wire404Exception();
You'd also have to consider it with navigation generation, perhaps skipping over pages that have the toggle set while in the default language, or adding it to your selectors when querying pages.

Edit: you could also just choose to not use the default language at all.

if($user->language->isDefault()) $user->language = $languages->get("en-us"); // or whatever you want your default to be

== Language Alternate Fields ==
Eine Möglichkeit alle Felder (auch Bilder) in verschiedenen Sprachen zu nutzen.
https://processwire.com/docs/multi-language-support/multi-language-fields/#language-alternate-fields

== Probleme lösen ==
=== Feldtyp nicht als Multilanguagefeld vorhanden - Language Alternate Field ===
Manche Felder (z.B. AssistedUrl) gibt es nur einsprachig. ProcessWire bietet aber mit den '''Language Alternate Fields''' eine Möglichkeit solche Felder mehrsprachig zu nutzen. Dazu braucht man kein Modul. Es ist eine Basis Funktionalität.

Dazu legt man für jede zusätzliche Sprache ein weiteres Feld mit dem selben Namen + der Namenserweiterung _sprachname an. Beispielsweise kann man für ein Feld Namens link ein weiteres Feld Namens '''link_en''' anlegen. Dann nutzt ProcessWire automatisch für die Sprache mit dem Namen '''en'''

== Beispiele ==

=== Multilanguage Page - Quickstart ===

==== 1. Module ====
* s.o. alle benötigten installieren

==== 2. Backend ====
* Default Sprache festlegen
** Wenn nicht Englisch Sprachpaket installieren
** Wenn der Titel der Sprache auch der Identifier für den html Tag sein soll muss er ''de, en, fi''... lauten
* Weitere Sprachen hinzufügen. Für Englisch benötigt man kein Sprachpaket. Als Name am besten den offiziellen Code (de, en...) vergeben.
* Die Homepage entscheidet über den Pfad. Wenn Englisch z.B. unter www.meineSeite.com/en/seitenname/ erreichbar sein soll, dann muss für Englisch unter '''Einstellung > Namen en''' eingetragen werden.
* Alle Felder die Übersetzt werden sollen auf Multilanguage Felder umstellen

==== 3. Templates ====
===== Lang Attribute =====

Das '''lang Attribut''' sollte zur Sprache passen.

'''Möglichkeit 1:'''

Mit der _x Funktion kann PW beliebige Strings in Templates übersetzten. PW findet diese automatisch.
_main.php (oder header..)
<html lang="<?php echo _x('en', 'HTML language code'); ?>">
Im '''Backend''' muss man zunächst für Englisch den '''Sprachindex aufbauen''' ('''Spracheinstellungen Verwaltung > Sprachen > Englisch''')

Dann kann man nun in den '''Spracheinstellungen Verwaltung > Sprachen > meineSprache''' das Label ''HTML language code'' suchen und mit dem passenden lang tag ersetzen.

Das Funktioniert auch mit beliebigen anderen Werten die man im Template hartkodiert hat.

'''Möglichkeit 2:'''

Man kann auch den Language Title verwenden wenn dieser entsprechend vergeben wurde (en, de,...) .

'''Nachteil:''' Dann kann man aber den Titel nicht mehr frei verändern wenn man ihn auch als Bezeichnung für den Language Switcher nutezn möchte.
<html lang="<?= $user->language->title ?>">

'''Möglichkeit 3'''

Dies hat bei mir nicht funktioniert:
<pre>
<? $lang = $pages->get(1)->getLanguageValue($user->language, 'name'); ?>
<html lang="<?php echo $lang ?>">
</pre>
Hier wird einfach der Name der Sprache die der Benutzer im Moment hat (Session) ausgegeben. Der Name der Sprache sollte im Backend entsprechend der Norm gewählt sein. (de, it, fi...). Problem war das man den Namen der default Sprache nicht vergeben kann.

==== 4. Language Switcher ====
'''Text Navigation''' z.B. so:
<syntaxhighlight lang="php">
<?php namespace ProcessWire;

?>
<ul id="nav-lang" class="nav nav-h">
<?php
foreach($languages as $language){
if(!$page->viewable($language)) continue; // is page viewable in this language?
if($language->id == $user->language->id) {
echo "<li class='current'>";
} else {
echo "<li>";
}
$url = $page->localUrl($language);
$hreflang = $pages->get('/')->getLanguageValue($language, 'name');
echo '<a hreflang="'.$hreflang.'" href="'.$url.'" style="text-transform:uppercase;">'.$language->title.'</a></li>';
echo "</li>";
}
?>
</ul>
</syntaxhighlight>

=====Textnavigation mit first/last etc. Klassen=====

<syntaxhighlight lang="php">
<?php namespace ProcessWire;

?>
<ul id="nav-lang" class="nav nav-h">
<?php
$n = $languages->count();
$i = 0;

$separator = '<span class="separator">|</span>';
foreach($languages as $language){
$liClass = array();
if(!$page->viewable($language)) continue; // is page viewable in this language?
$i++;
if( $i == 1 ) $liClass[] = "first";
if( $i == $n ) $liClass[] = "last";
if($language->id == $user->language->id) $liClass[] = 'current';
echo '<li class="'.implode(' ',$liClass).'">';
$url = $page->localUrl($language);
$hreflang = $pages->get('/')->getLanguageValue($language, 'name');
echo '<a hreflang="'.$hreflang.'" href="'.$url.'" style="text-transform:uppercase;">'.$language->title.'</a></li>';
if( $i < $n ) echo $separator;
echo "</li>";
}
?>
</ul>
</syntaxhighlight>

=====Flaggennavi=====
z.B. so :
<syntaxhighlight lang="php">
<?php namespace ProcessWire;

?>
<ul id="nav-lang" class="">
<?php
foreach($languages as $language){
if(!$page->viewable($language)) continue; // is page viewable in this language?
if($language->id == $user->language->id) {

echo '<li class="current" style="opacity:0.5;">';
} else {
echo '<li>';
}
$flag = urls()->templates.'assets/flag-'.$language->name.'.png';
$url = $page->localUrl($language);
$hreflang = $pages->get('/')->getLanguageValue($language, 'name');
echo '<a hreflang="'.$hreflang.'" href="'.$url.'"><img class="flag" src="'.$flag.'" style="width: 100px;"></a></li>';
echo '</li>';
}
?>
</ul>
</syntaxhighlight>

===== Language Toggle Schiebeschalter =====
Siehe auch Codepen "Kholja"
<syntaxhighlight lang="html5">
<h2>Fixed width label</h2>

<div class="language-switcher-fixed">

<a href="/en" class="toggle-switch en" title="Wechsel zu Englisch">
<div class="switch">
<div class="knob"></div>
<div class="label">en</div>
</div>
</a>


<a href="/de" class="toggle-switch de" title="Wechsel zu Deutsch">
<div class="switch">
<div class="knob"></div>
<div class="label">de</div>
</div>
</a>
</div>

<h2>Dynamic width label</h2>
<div class="language-switcher-dynamic">

<a href="/de" class="toggle-switch de" title="Wechsel zu Deutsch">
<div class="switch">
<div class="knob"></div>
<span class="label">Deutsch</span>
</div>
</a>


<a href="/en" class="toggle-switch en" title="Wechsel zu Englisch">
<div class="switch">
<div class="knob"></div>
<span class="label">English</span>
</div>
</a>
</div>
</syntaxhighlight>

<syntaxhighlight lang="scss">
$switch-background-color :#006B52;
$switch-background-color-hover: #4a9a14;
$label-color: #fff;
// $border-color: rgba(0,0,0,0.5);
$switch-border-color: #fff;
$knob-color: #006B52;
// $knob-border-color: rgba(0,0,0,0.5);
$knob-border-color: transparent;
$knob-background-color: #fff;
body{
font-family: Helvetica, sans-serif;
background: #006B52;
color: white;
}
h2{
text-align: center;
}
.language-switcher-fixed, .language-switcher-dynamic{
padding: 40px;
justify-content: center;
}
/* fixed width */
.language-switcher-fixed {
display: flex;
gap: 1rem;

.toggle-switch {
text-decoration: none;
display: inline-block;

.switch {
position: relative;
width: 64px;
height: 32px;
background-color: $switch-background-color;
border-radius: 16px;
border: 1px solid $switch-border-color;
transition: background-color 0.3s ease;
}

.knob {
position: absolute;
top: 3px;
width: 24px;
height: 24px;
background-color: $knob-background-color;
border-radius: 50%;
border: 1px solid $knob-border-color;
transition: all 0.3s ease;
}

.label {
position: absolute;
top: 50%;
transform: translateY(-50%);
font-size: 15px;
font-weight: bold;
text-transform: uppercase;
color: $label-color;
}
}

/* Deutscher Schalter: Knopf links, Beschriftung rechts */
.toggle-switch.de {
.knob {
left: 2px;
}
.label {
right: 8px;
}
}

/* Englischer Schalter: Knopf rechts, Beschriftung links */
.toggle-switch.en {
.knob {
right: 2px;
}
.label {
left: 8px;
}
}

/* Hover- und Active-Effekte */
.toggle-switch:hover .switch {
background-color: $switch-background-color-hover;
}
.toggle-switch:active .knob {
transform: scale(0.95);
}

}

/* dynamic width */
.language-switcher-dynamic {
display: flex;
gap: 1rem;
.toggle-switch {
text-decoration: none;
display: inline-block;

.switch {
display: inline-flex;
align-items: center;
border-radius: 21px;
border: 1px solid $switch-border-color;
background-color: $switch-background-color;
padding: 5px 10px;
transition: background-color 0.3s ease;
/* Die Breite passt sich automatisch an den Inhalt an */
}

.knob {
width: 26px;
height: 26px;
background-color: $knob-background-color;
border-radius: 50%;
box-shadow: 0 1px 3px rgba(0, 0, 0, 0.3);
transition: transform 0.3s ease;
flex-shrink: 0;
}

.label {
font-size: 0.9rem;
font-weight: bold;
color: $label-color;
margin: 0 5px;
text-transform: uppercase;
}
}

/* Deutscher Schalter: Knopf links, Label rechts */
.toggle-switch.de .switch {
flex-direction: row;
}

/* Englischer Schalter: Knopf rechts, Label links */
.toggle-switch.en .switch {
flex-direction: row-reverse;
}

/* Hover- und Active-Effekte */
.toggle-switch:hover .switch {
background-color: $switch-background-color-hover;
}

.toggle-switch:active .knob {
transform: scale(0.95);
}

}

</syntaxhighlight>

=== Prantner ===
Hauptnavigation mit Flaggen:

language-switcher.inc
<syntaxhighlight lang="php">
<?php namespace ProcessWire;
$imgMarkup = "";
$out = "";
foreach($languages as $language) {
if(!$page->viewable($language)) continue; // is page viewable in this language?
$url = $page->localUrl($language);
$hreflang = $homepage->getLanguageValue($language, 'name');
$imgUrl = $config->urls->templates.'assets/flags/'.$language->name.'_sq.png';
$imgMarkup = "<img src=\"$imgUrl\" title=\"$language->title\" alt=\"$language->title\" class=\"circle z-depth-1\">";
if($language->id == $user->language->id) {
$out .= "<span class=\"lang-button current\">";
} else {
$out .= "<span class=\"lang-button\">";
}
$out .= "<a hreflang=\"$hreflang\" href=\"$url\">$imgMarkup</a></span>";
}
$out = '<div id="nav-lang">'.$out.'</div>';
echo $out;
?>
</syntaxhighlight>

language-switcher-mobile.inc
<syntaxhighlight lang="php">
<?php namespace ProcessWire;
?>
<ul id="nav-mobile" class="right hide-on-med-and-down">
<?php
foreach($languages as $language) {
if(!$page->viewable($language)) continue; // is page viewable in this language?
if($language->id == $user->language->id) {
echo "<li class='current'>";
} else {
echo "<li>";
}
$url = $page->localUrl($language);
$hreflang = $homepage->getLanguageValue($language, 'name');
echo "<a hreflang='$hreflang' href='$url'>$language->title</a></li>";
}
?>
</ul>
</syntaxhighlight>

== Language Snippets ==
=== URL der Sprache ===
getLanguageValue($language->id, 'url');
$page->localHttpUrl($language->id);
$page->localUrl($language->id);

=== Field Label in aktueller Sprache ===
fields($f)->getLabel()
Wobei $f ein Feldname sein kann aber auch ein Feldobjekt.

ProcessWire - Multilanguage Website

2025-03-22T09:35:02Z

109.193.152.88: /* Flaggennavi */

Mehrsprachige Websites mit ProcessWire / Andere Default Sprache

== Links ==
* https://processwire.com/docs/multi-language-support/
* https://processwire.com/talk/topic/5518-multi-language-site/
* http://processwire.com/api/multi-language-support/multi-language-urls/
* https://processwire.com/talk/topic/9322-change-default-language-for-homepage/ (Modul Solution, mehr zur Anschauung)

== Einleitung ==
Es gibt mehrere Bereiche an die man denken muss. Einmal geht es um die Eingabe im Backend, die Ausgabe im Frontend, die Sprachnavigation auf der Website und die Templates:
* Wie übersetze ich Text in meinen '''Templates''' ? Siehe unten i18n
* Wie übersetze ich '''Inhalte''' im Backend ? Dafür ist das Modul Language Support Fields zuständig
* Wie sollen meine URLs aussehen ? Prinzipiell kann man jedem User unterschiedliche Sprachen auch ohne andere Domain liefern (über seine Session) aber i.d.R wollen wir die URL anzupassen.
** ''domain.de/en/meineSeite'' oder ''domain.de/myPage''
** Um '''Seitennamen''' zu übersetzen oder ein Domainkürzel in der URL voranzustellen benötige ich das Modul '''Language Support Page Names'''

== Welche Module benötige ich ==
Da es einige Module in diesem Zusammenhang gibt hier eine Übersicht. Man findet Sie am besten unter
Modules > Core > Language

* '''Languages Support''' - ProcessWire multi-language support. Basis Modul bracht man für alle Beispiele unten. Reicht aus, wenn man nur die Standard-Sprache ändern will. '''Hinweis:''' In der aktuellen PW3 Version schlägt einem ProcessWire nach Installation des Language Support Moduls gleich die Ergänzenden Module (s.u.) vor und man kann den Installationsprozess ziemlich fix erledigen.
* '''Languages Support - Fields''' Required to use multi-language fields. Basis für mehrsprachige Felder im Backend.
* '''Languages Support - Page Names''' (LanguageSupportPageNames) Required to use multi-language page names. Braucht man nur wenn '''alle Seiten in allen Sprachen unterschiedliche Namen''' bekommen sollen.
* '''Languages Support - Tabs''' Organizes multi-language fields into tabs for a cleaner easier to use interface.
Für mehrsprachige Seiten benötigen wir im Frontend i.d.R. folgende Module:
* '''Language Support Fields''' - Sind Felder, die im Backend für jede Sprache eine eigene Eingabe bieten.
* '''Language Support Page Names''' benötigt man, damit man für die Sprachen eigene URLs angeben kann. Z.B. bei Home in Englisch /en/ usw.
* '''FieldtypePageTitleLanguage''' benötigt man wenn man alle Seitenamen anpassen will (seite1_de seite1_fr ...) Für einen reinen Sprachpfad (/de/Seite) braucht man das nicht.

== Einsprachige Seite aber Deutsch als Default Sprache ==
Wenn nur die Standardsprache verändern möchte, aber keine Mehrsprachige Seite benötigt brauchen wir nur das Modul '''Language Support'''
* Enable languages support -> '''Core Module "Language Support" aktivieren'''. -> Sprachen stehen num im Backend Setup zur Verfügung
* '''Titel der Default Sprache''' anpassen (z.B. Deutsch (default) )
* Language Pack in der default Sprache installieren -> Dies ist ab jetzt die Default Sprache. Nicht vergessen auch den '''lang Tag im Header''' zu setzen, damit der Browser die Sprache richtig erkennt.

== Sprachpakete installieren ==
https://processwire.com/modules/category/language-pack/
* Sprache auswählen und dort komplettes zip hochladen.
* Informell (DU) leider im Moment nicht vorhanden

== Basis-Module für Mehrsprachigkeit im Backend ==
Für mehrsprachige Seiten benötigen wir i.d.R. folgende Module:
* '''Language Support Fields''' für die Backend Übersetzungen und '''Language Support Page Names''' für die URLs.
* '''FieldtypePageTitleLanguage''' benötigt man wenn man alle Seitenamen anpassen will (seite1_de seite1_fr ...) Für einen reinen Sprachpfad (/de/Seite) braucht man das nicht.
* Für weitere Sprachen entsprechend hinzufügen.
Vorgehen:
* Language Packs installieren: drop in the none english language pack (for admin backend) into the default language, (e.g. german langpack)
* As a nice sideeffect every new user in your system gets the native language per default without have it to select from the list.

== Templates für Multilanguage vorbereiten (i18n) ==
https://processwire.com/docs/multi-language-support/code-i18n/
https://processwire.com/blog/posts/functional-fields/
=== Functional fields ===
In PW3 kamen die functional Fields hinzu. Mit diesen kann man statischen Text dynamisch im Page Editor ansprechen. D.h. das Functional Field findet Texte im Template und macht sie automatisch editierbar im Page Editor. Das Ganze funktioniert auch Mehrsprachig.
[[ProcessWire - Functional Fields]]
https://processwire.com/blog/posts/functional-fields/
Beispiele für die Ausgabe von
<pre>
__text('your text');
__textarea('your text');
__richtext('<p>your text</p>');
__text('Subscribe Now', 'subscribe') // define a identifier for this text snippet...
__text('subscribe') // ..reuse it this way
$pages->get('/')->mytext->subscribe // reuse from another template
__text('Subscribe Now', 'subscribe', 'Submit button'); // Label for page editor
__text('Subscribe Now', 'subscribe', 'label=Submit button, notes=Test'); // or use a pw selector
__text('Subscribe Now', 'name=subscribe, label=Submit button, notes=Test'); // equivalent to upper

</pre>

=== Standard Multilanguage nach i18n ===

$out = $this->_("Live long and prosper"); // syntax within a class
$out = __("Live long and prosper!"); // syntax outside of a class

Dann im Backend unter der Sprache "Find files to translate" und die Template Datei auswählen.

=== Variablen in i18n ===
$out = sprintf(__("Created %d pages."), $count);
$out = sprintf(__('Your city is %1$s, and your zip code is %2$s.'), $city, $zipcode);

=== Plural in Multilanguage Files===
Hierzu gibt es die _n() Funktion
$out = sprintf(_n("Created %d page.", "Created %d pages.", $count), $count);
=== Unterschiedliche Übersetzungen bei gleichem Wortlaut ===
Manchmal muss der Begriff in anderen Sprachen unterschiedlich übersetzt werden, obwohl er in der Default Sprache gleich lautet:
<pre>
$label = _x('Comment', 'noun'); // or $this->_x('Comment', 'noun') in a class
...
// some other place in the code
echo _x('Comment', 'column name');
</pre>

=== Kommentare für den Übersetzer und User ===
$date = __('g:i:s a'); // Date string in PHP date() format
echo __("Welcome Guest"); // Headline for guest user // Keep it short (2-3 words)
=== Regeln ===
* Eine Zeile ein Paar Anführungszeichen
* Nur eine Übersetzungsfunktion pro Zeile

== Language Switcher ==
<syntaxhighlight lang="php">
// remember what language is set to
$savedLanguage = $user->language;

foreach($languages as $language) {

// if user is already viewing the page in this language, skip it
if($language->id == $savedLanguage->id) continue;

// if this page isn't viewable (active) for the language, skip it
if(!$page->viewable($language)) continue;

// set the user's language, so that the $page->url and any other
// fields we access from it will be reflective of the $language
$user->language = $language;

// output a link to this page in the other language
echo "<li><a href='$page->url'>$language->title: $page->title</a></li>";
}
// restore the original language setting
$user->language = $savedLanguage;
</syntaxhighlight>

== Seiten nur in einer Sprache verfügbar ==
What If I want to create/publish a page only in DE language, and that page should not be available in the default language?
Default language is required. But you could always add your own checkbox field to the page as a toggle to disable it. Your head.inc or _init.php or whatever your common initialization file is could check:

if($page->disable_default_language && $user->language->isDefault()) throw new Wire404Exception();
You'd also have to consider it with navigation generation, perhaps skipping over pages that have the toggle set while in the default language, or adding it to your selectors when querying pages.

Edit: you could also just choose to not use the default language at all.

if($user->language->isDefault()) $user->language = $languages->get("en-us"); // or whatever you want your default to be

== Language Alternate Fields ==
Eine Möglichkeit alle Felder (auch Bilder) in verschiedenen Sprachen zu nutzen.
https://processwire.com/docs/multi-language-support/multi-language-fields/#language-alternate-fields

== Probleme lösen ==
=== Feldtyp nicht als Multilanguagefeld vorhanden - Language Alternate Field ===
Manche Felder (z.B. AssistedUrl) gibt es nur einsprachig. ProcessWire bietet aber mit den '''Language Alternate Fields''' eine Möglichkeit solche Felder mehrsprachig zu nutzen. Dazu braucht man kein Modul. Es ist eine Basis Funktionalität.

Dazu legt man für jede zusätzliche Sprache ein weiteres Feld mit dem selben Namen + der Namenserweiterung _sprachname an. Beispielsweise kann man für ein Feld Namens link ein weiteres Feld Namens '''link_en''' anlegen. Dann nutzt ProcessWire automatisch für die Sprache mit dem Namen '''en'''

== Beispiele ==

=== Multilanguage Page - Quickstart ===

==== 1. Module ====
* s.o. alle benötigten installieren

==== 2. Backend ====
* Default Sprache festlegen
** Wenn nicht Englisch Sprachpaket installieren
** Wenn der Titel der Sprache auch der Identifier für den html Tag sein soll muss er ''de, en, fi''... lauten
* Weitere Sprachen hinzufügen. Für Englisch benötigt man kein Sprachpaket. Als Name am besten den offiziellen Code (de, en...) vergeben.
* Die Homepage entscheidet über den Pfad. Wenn Englisch z.B. unter www.meineSeite.com/en/seitenname/ erreichbar sein soll, dann muss für Englisch unter '''Einstellung > Namen en''' eingetragen werden.
* Alle Felder die Übersetzt werden sollen auf Multilanguage Felder umstellen

==== 3. Templates ====
===== Lang Attribute =====

Das '''lang Attribut''' sollte zur Sprache passen.

'''Möglichkeit 1:'''

Mit der _x Funktion kann PW beliebige Strings in Templates übersetzten. PW findet diese automatisch.
_main.php (oder header..)
<html lang="<?php echo _x('en', 'HTML language code'); ?>">
Im '''Backend''' muss man zunächst für Englisch den '''Sprachindex aufbauen''' ('''Spracheinstellungen Verwaltung > Sprachen > Englisch''')

Dann kann man nun in den '''Spracheinstellungen Verwaltung > Sprachen > meineSprache''' das Label ''HTML language code'' suchen und mit dem passenden lang tag ersetzen.

Das Funktioniert auch mit beliebigen anderen Werten die man im Template hartkodiert hat.

'''Möglichkeit 2:'''

Man kann auch den Language Title verwenden wenn dieser entsprechend vergeben wurde (en, de,...) .

'''Nachteil:''' Dann kann man aber den Titel nicht mehr frei verändern wenn man ihn auch als Bezeichnung für den Language Switcher nutezn möchte.
<html lang="<?= $user->language->title ?>">

'''Möglichkeit 3'''

Dies hat bei mir nicht funktioniert:
<pre>
<? $lang = $pages->get(1)->getLanguageValue($user->language, 'name'); ?>
<html lang="<?php echo $lang ?>">
</pre>
Hier wird einfach der Name der Sprache die der Benutzer im Moment hat (Session) ausgegeben. Der Name der Sprache sollte im Backend entsprechend der Norm gewählt sein. (de, it, fi...). Problem war das man den Namen der default Sprache nicht vergeben kann.

==== 4. Language Switcher ====
'''Text Navigation''' z.B. so:
<syntaxhighlight lang="php">
<?php namespace ProcessWire;

?>
<ul id="nav-lang" class="nav nav-h">
<?php
foreach($languages as $language){
if(!$page->viewable($language)) continue; // is page viewable in this language?
if($language->id == $user->language->id) {
echo "<li class='current'>";
} else {
echo "<li>";
}
$url = $page->localUrl($language);
$hreflang = $pages->get('/')->getLanguageValue($language, 'name');
echo '<a hreflang="'.$hreflang.'" href="'.$url.'" style="text-transform:uppercase;">'.$language->title.'</a></li>';
echo "</li>";
}
?>
</ul>
</syntaxhighlight>

=====Textnavigation mit first/last etc. Klassen=====

<syntaxhighlight lang="php">
<?php namespace ProcessWire;

?>
<ul id="nav-lang" class="nav nav-h">
<?php
$n = $languages->count();
$i = 0;

$separator = '<span class="separator">|</span>';
foreach($languages as $language){
$liClass = array();
if(!$page->viewable($language)) continue; // is page viewable in this language?
$i++;
if( $i == 1 ) $liClass[] = "first";
if( $i == $n ) $liClass[] = "last";
if($language->id == $user->language->id) $liClass[] = 'current';
echo '<li class="'.implode(' ',$liClass).'">';
$url = $page->localUrl($language);
$hreflang = $pages->get('/')->getLanguageValue($language, 'name');
echo '<a hreflang="'.$hreflang.'" href="'.$url.'" style="text-transform:uppercase;">'.$language->title.'</a></li>';
if( $i < $n ) echo $separator;
echo "</li>";
}
?>
</ul>
</syntaxhighlight>

=====Flaggennavi=====
z.B. so :
<syntaxhighlight lang="php">
<?php namespace ProcessWire;

?>
<ul id="nav-lang" class="">
<?php
foreach($languages as $language){
if(!$page->viewable($language)) continue; // is page viewable in this language?
if($language->id == $user->language->id) {

echo '<li class="current" style="opacity:0.5;">';
} else {
echo '<li>';
}
$flag = urls()->templates.'assets/flag-'.$language->name.'.png';
$url = $page->localUrl($language);
$hreflang = $pages->get('/')->getLanguageValue($language, 'name');
echo '<a hreflang="'.$hreflang.'" href="'.$url.'"><img class="flag" src="'.$flag.'" style="width: 100px;"></a></li>';
echo '</li>';
}
?>
</ul>
</syntaxhighlight>

===== Language Toggle Schiebeschalter =====
Siehe auch Codepen "Kholja"
<syntaxhighlight lang="html5">
<h2>Fixed width label</h2>

<div class="language-switcher-fixed">

<a href="/en" class="toggle-switch en" title="Wechsel zu Englisch">
<div class="switch">
<div class="knob"></div>
<div class="label">en</div>
</div>
</a>


<a href="/de" class="toggle-switch de" title="Wechsel zu Deutsch">
<div class="switch">
<div class="knob"></div>
<div class="label">de</div>
</div>
</a>
</div>

<h2>Dynamic width label</h2>
<div class="language-switcher-dynamic">

<a href="/de" class="toggle-switch de" title="Wechsel zu Deutsch">
<div class="switch">
<div class="knob"></div>
<span class="label">Deutsch</span>
</div>
</a>


<a href="/en" class="toggle-switch en" title="Wechsel zu Englisch">
<div class="switch">
<div class="knob"></div>
<span class="label">English</span>
</div>
</a>
</div>

</syntaxhighlight
<syntaxhighlight lang="scss">
$switch-background-color :#006B52;
$switch-background-color-hover: #4a9a14;
$label-color: #fff;
// $border-color: rgba(0,0,0,0.5);
$switch-border-color: #fff;
$knob-color: #006B52;
// $knob-border-color: rgba(0,0,0,0.5);
$knob-border-color: transparent;
$knob-background-color: #fff;
body{
font-family: Helvetica, sans-serif;
background: #006B52;
color: white;
}
h2{
text-align: center;
}
.language-switcher-fixed, .language-switcher-dynamic{
padding: 40px;
justify-content: center;
}
/* fixed width */
.language-switcher-fixed {
display: flex;
gap: 1rem;

.toggle-switch {
text-decoration: none;
display: inline-block;

.switch {
position: relative;
width: 64px;
height: 32px;
background-color: $switch-background-color;
border-radius: 16px;
border: 1px solid $switch-border-color;
transition: background-color 0.3s ease;
}

.knob {
position: absolute;
top: 3px;
width: 24px;
height: 24px;
background-color: $knob-background-color;
border-radius: 50%;
border: 1px solid $knob-border-color;
transition: all 0.3s ease;
}

.label {
position: absolute;
top: 50%;
transform: translateY(-50%);
font-size: 15px;
font-weight: bold;
text-transform: uppercase;
color: $label-color;
}
}

/* Deutscher Schalter: Knopf links, Beschriftung rechts */
.toggle-switch.de {
.knob {
left: 2px;
}
.label {
right: 8px;
}
}

/* Englischer Schalter: Knopf rechts, Beschriftung links */
.toggle-switch.en {
.knob {
right: 2px;
}
.label {
left: 8px;
}
}

/* Hover- und Active-Effekte */
.toggle-switch:hover .switch {
background-color: $switch-background-color-hover;
}
.toggle-switch:active .knob {
transform: scale(0.95);
}

}

/* dynamic width */
.language-switcher-dynamic {
display: flex;
gap: 1rem;
.toggle-switch {
text-decoration: none;
display: inline-block;

.switch {
display: inline-flex;
align-items: center;
border-radius: 21px;
border: 1px solid $switch-border-color;
background-color: $switch-background-color;
padding: 5px 10px;
transition: background-color 0.3s ease;
/* Die Breite passt sich automatisch an den Inhalt an */
}

.knob {
width: 26px;
height: 26px;
background-color: $knob-background-color;
border-radius: 50%;
box-shadow: 0 1px 3px rgba(0, 0, 0, 0.3);
transition: transform 0.3s ease;
flex-shrink: 0;
}

.label {
font-size: 0.9rem;
font-weight: bold;
color: $label-color;
margin: 0 5px;
text-transform: uppercase;
}
}

/* Deutscher Schalter: Knopf links, Label rechts */
.toggle-switch.de .switch {
flex-direction: row;
}

/* Englischer Schalter: Knopf rechts, Label links */
.toggle-switch.en .switch {
flex-direction: row-reverse;
}

/* Hover- und Active-Effekte */
.toggle-switch:hover .switch {
background-color: $switch-background-color-hover;
}

.toggle-switch:active .knob {
transform: scale(0.95);
}

}

</syntaxhighlight>

=== Prantner ===
Hauptnavigation mit Flaggen:

language-switcher.inc
<syntaxhighlight lang="php">
<?php namespace ProcessWire;
$imgMarkup = "";
$out = "";
foreach($languages as $language) {
if(!$page->viewable($language)) continue; // is page viewable in this language?
$url = $page->localUrl($language);
$hreflang = $homepage->getLanguageValue($language, 'name');
$imgUrl = $config->urls->templates.'assets/flags/'.$language->name.'_sq.png';
$imgMarkup = "<img src=\"$imgUrl\" title=\"$language->title\" alt=\"$language->title\" class=\"circle z-depth-1\">";
if($language->id == $user->language->id) {
$out .= "<span class=\"lang-button current\">";
} else {
$out .= "<span class=\"lang-button\">";
}
$out .= "<a hreflang=\"$hreflang\" href=\"$url\">$imgMarkup</a></span>";
}
$out = '<div id="nav-lang">'.$out.'</div>';
echo $out;
?>
</syntaxhighlight>

language-switcher-mobile.inc
<syntaxhighlight lang="php">
<?php namespace ProcessWire;
?>
<ul id="nav-mobile" class="right hide-on-med-and-down">
<?php
foreach($languages as $language) {
if(!$page->viewable($language)) continue; // is page viewable in this language?
if($language->id == $user->language->id) {
echo "<li class='current'>";
} else {
echo "<li>";
}
$url = $page->localUrl($language);
$hreflang = $homepage->getLanguageValue($language, 'name');
echo "<a hreflang='$hreflang' href='$url'>$language->title</a></li>";
}
?>
</ul>
</syntaxhighlight>

== Language Snippets ==
=== URL der Sprache ===
getLanguageValue($language->id, 'url');
$page->localHttpUrl($language->id);
$page->localUrl($language->id);

=== Field Label in aktueller Sprache ===
fields($f)->getLabel()
Wobei $f ein Feldname sein kann aber auch ein Feldobjekt.

ProcessWire - Multilanguage Website

2025-03-22T09:34:45Z

109.193.152.88: /* 4. Language Switcher */

Mehrsprachige Websites mit ProcessWire / Andere Default Sprache

== Links ==
* https://processwire.com/docs/multi-language-support/
* https://processwire.com/talk/topic/5518-multi-language-site/
* http://processwire.com/api/multi-language-support/multi-language-urls/
* https://processwire.com/talk/topic/9322-change-default-language-for-homepage/ (Modul Solution, mehr zur Anschauung)

== Einleitung ==
Es gibt mehrere Bereiche an die man denken muss. Einmal geht es um die Eingabe im Backend, die Ausgabe im Frontend, die Sprachnavigation auf der Website und die Templates:
* Wie übersetze ich Text in meinen '''Templates''' ? Siehe unten i18n
* Wie übersetze ich '''Inhalte''' im Backend ? Dafür ist das Modul Language Support Fields zuständig
* Wie sollen meine URLs aussehen ? Prinzipiell kann man jedem User unterschiedliche Sprachen auch ohne andere Domain liefern (über seine Session) aber i.d.R wollen wir die URL anzupassen.
** ''domain.de/en/meineSeite'' oder ''domain.de/myPage''
** Um '''Seitennamen''' zu übersetzen oder ein Domainkürzel in der URL voranzustellen benötige ich das Modul '''Language Support Page Names'''

== Welche Module benötige ich ==
Da es einige Module in diesem Zusammenhang gibt hier eine Übersicht. Man findet Sie am besten unter
Modules > Core > Language

* '''Languages Support''' - ProcessWire multi-language support. Basis Modul bracht man für alle Beispiele unten. Reicht aus, wenn man nur die Standard-Sprache ändern will. '''Hinweis:''' In der aktuellen PW3 Version schlägt einem ProcessWire nach Installation des Language Support Moduls gleich die Ergänzenden Module (s.u.) vor und man kann den Installationsprozess ziemlich fix erledigen.
* '''Languages Support - Fields''' Required to use multi-language fields. Basis für mehrsprachige Felder im Backend.
* '''Languages Support - Page Names''' (LanguageSupportPageNames) Required to use multi-language page names. Braucht man nur wenn '''alle Seiten in allen Sprachen unterschiedliche Namen''' bekommen sollen.
* '''Languages Support - Tabs''' Organizes multi-language fields into tabs for a cleaner easier to use interface.
Für mehrsprachige Seiten benötigen wir im Frontend i.d.R. folgende Module:
* '''Language Support Fields''' - Sind Felder, die im Backend für jede Sprache eine eigene Eingabe bieten.
* '''Language Support Page Names''' benötigt man, damit man für die Sprachen eigene URLs angeben kann. Z.B. bei Home in Englisch /en/ usw.
* '''FieldtypePageTitleLanguage''' benötigt man wenn man alle Seitenamen anpassen will (seite1_de seite1_fr ...) Für einen reinen Sprachpfad (/de/Seite) braucht man das nicht.

== Einsprachige Seite aber Deutsch als Default Sprache ==
Wenn nur die Standardsprache verändern möchte, aber keine Mehrsprachige Seite benötigt brauchen wir nur das Modul '''Language Support'''
* Enable languages support -> '''Core Module "Language Support" aktivieren'''. -> Sprachen stehen num im Backend Setup zur Verfügung
* '''Titel der Default Sprache''' anpassen (z.B. Deutsch (default) )
* Language Pack in der default Sprache installieren -> Dies ist ab jetzt die Default Sprache. Nicht vergessen auch den '''lang Tag im Header''' zu setzen, damit der Browser die Sprache richtig erkennt.

== Sprachpakete installieren ==
https://processwire.com/modules/category/language-pack/
* Sprache auswählen und dort komplettes zip hochladen.
* Informell (DU) leider im Moment nicht vorhanden

== Basis-Module für Mehrsprachigkeit im Backend ==
Für mehrsprachige Seiten benötigen wir i.d.R. folgende Module:
* '''Language Support Fields''' für die Backend Übersetzungen und '''Language Support Page Names''' für die URLs.
* '''FieldtypePageTitleLanguage''' benötigt man wenn man alle Seitenamen anpassen will (seite1_de seite1_fr ...) Für einen reinen Sprachpfad (/de/Seite) braucht man das nicht.
* Für weitere Sprachen entsprechend hinzufügen.
Vorgehen:
* Language Packs installieren: drop in the none english language pack (for admin backend) into the default language, (e.g. german langpack)
* As a nice sideeffect every new user in your system gets the native language per default without have it to select from the list.

== Templates für Multilanguage vorbereiten (i18n) ==
https://processwire.com/docs/multi-language-support/code-i18n/
https://processwire.com/blog/posts/functional-fields/
=== Functional fields ===
In PW3 kamen die functional Fields hinzu. Mit diesen kann man statischen Text dynamisch im Page Editor ansprechen. D.h. das Functional Field findet Texte im Template und macht sie automatisch editierbar im Page Editor. Das Ganze funktioniert auch Mehrsprachig.
[[ProcessWire - Functional Fields]]
https://processwire.com/blog/posts/functional-fields/
Beispiele für die Ausgabe von
<pre>
__text('your text');
__textarea('your text');
__richtext('<p>your text</p>');
__text('Subscribe Now', 'subscribe') // define a identifier for this text snippet...
__text('subscribe') // ..reuse it this way
$pages->get('/')->mytext->subscribe // reuse from another template
__text('Subscribe Now', 'subscribe', 'Submit button'); // Label for page editor
__text('Subscribe Now', 'subscribe', 'label=Submit button, notes=Test'); // or use a pw selector
__text('Subscribe Now', 'name=subscribe, label=Submit button, notes=Test'); // equivalent to upper

</pre>

=== Standard Multilanguage nach i18n ===

$out = $this->_("Live long and prosper"); // syntax within a class
$out = __("Live long and prosper!"); // syntax outside of a class

Dann im Backend unter der Sprache "Find files to translate" und die Template Datei auswählen.

=== Variablen in i18n ===
$out = sprintf(__("Created %d pages."), $count);
$out = sprintf(__('Your city is %1$s, and your zip code is %2$s.'), $city, $zipcode);

=== Plural in Multilanguage Files===
Hierzu gibt es die _n() Funktion
$out = sprintf(_n("Created %d page.", "Created %d pages.", $count), $count);
=== Unterschiedliche Übersetzungen bei gleichem Wortlaut ===
Manchmal muss der Begriff in anderen Sprachen unterschiedlich übersetzt werden, obwohl er in der Default Sprache gleich lautet:
<pre>
$label = _x('Comment', 'noun'); // or $this->_x('Comment', 'noun') in a class
...
// some other place in the code
echo _x('Comment', 'column name');
</pre>

=== Kommentare für den Übersetzer und User ===
$date = __('g:i:s a'); // Date string in PHP date() format
echo __("Welcome Guest"); // Headline for guest user // Keep it short (2-3 words)
=== Regeln ===
* Eine Zeile ein Paar Anführungszeichen
* Nur eine Übersetzungsfunktion pro Zeile

== Language Switcher ==
<syntaxhighlight lang="php">
// remember what language is set to
$savedLanguage = $user->language;

foreach($languages as $language) {

// if user is already viewing the page in this language, skip it
if($language->id == $savedLanguage->id) continue;

// if this page isn't viewable (active) for the language, skip it
if(!$page->viewable($language)) continue;

// set the user's language, so that the $page->url and any other
// fields we access from it will be reflective of the $language
$user->language = $language;

// output a link to this page in the other language
echo "<li><a href='$page->url'>$language->title: $page->title</a></li>";
}
// restore the original language setting
$user->language = $savedLanguage;
</syntaxhighlight>

== Seiten nur in einer Sprache verfügbar ==
What If I want to create/publish a page only in DE language, and that page should not be available in the default language?
Default language is required. But you could always add your own checkbox field to the page as a toggle to disable it. Your head.inc or _init.php or whatever your common initialization file is could check:

if($page->disable_default_language && $user->language->isDefault()) throw new Wire404Exception();
You'd also have to consider it with navigation generation, perhaps skipping over pages that have the toggle set while in the default language, or adding it to your selectors when querying pages.

Edit: you could also just choose to not use the default language at all.

if($user->language->isDefault()) $user->language = $languages->get("en-us"); // or whatever you want your default to be

== Language Alternate Fields ==
Eine Möglichkeit alle Felder (auch Bilder) in verschiedenen Sprachen zu nutzen.
https://processwire.com/docs/multi-language-support/multi-language-fields/#language-alternate-fields

== Probleme lösen ==
=== Feldtyp nicht als Multilanguagefeld vorhanden - Language Alternate Field ===
Manche Felder (z.B. AssistedUrl) gibt es nur einsprachig. ProcessWire bietet aber mit den '''Language Alternate Fields''' eine Möglichkeit solche Felder mehrsprachig zu nutzen. Dazu braucht man kein Modul. Es ist eine Basis Funktionalität.

Dazu legt man für jede zusätzliche Sprache ein weiteres Feld mit dem selben Namen + der Namenserweiterung _sprachname an. Beispielsweise kann man für ein Feld Namens link ein weiteres Feld Namens '''link_en''' anlegen. Dann nutzt ProcessWire automatisch für die Sprache mit dem Namen '''en'''

== Beispiele ==

=== Multilanguage Page - Quickstart ===

==== 1. Module ====
* s.o. alle benötigten installieren

==== 2. Backend ====
* Default Sprache festlegen
** Wenn nicht Englisch Sprachpaket installieren
** Wenn der Titel der Sprache auch der Identifier für den html Tag sein soll muss er ''de, en, fi''... lauten
* Weitere Sprachen hinzufügen. Für Englisch benötigt man kein Sprachpaket. Als Name am besten den offiziellen Code (de, en...) vergeben.
* Die Homepage entscheidet über den Pfad. Wenn Englisch z.B. unter www.meineSeite.com/en/seitenname/ erreichbar sein soll, dann muss für Englisch unter '''Einstellung > Namen en''' eingetragen werden.
* Alle Felder die Übersetzt werden sollen auf Multilanguage Felder umstellen

==== 3. Templates ====
===== Lang Attribute =====

Das '''lang Attribut''' sollte zur Sprache passen.

'''Möglichkeit 1:'''

Mit der _x Funktion kann PW beliebige Strings in Templates übersetzten. PW findet diese automatisch.
_main.php (oder header..)
<html lang="<?php echo _x('en', 'HTML language code'); ?>">
Im '''Backend''' muss man zunächst für Englisch den '''Sprachindex aufbauen''' ('''Spracheinstellungen Verwaltung > Sprachen > Englisch''')

Dann kann man nun in den '''Spracheinstellungen Verwaltung > Sprachen > meineSprache''' das Label ''HTML language code'' suchen und mit dem passenden lang tag ersetzen.

Das Funktioniert auch mit beliebigen anderen Werten die man im Template hartkodiert hat.

'''Möglichkeit 2:'''

Man kann auch den Language Title verwenden wenn dieser entsprechend vergeben wurde (en, de,...) .

'''Nachteil:''' Dann kann man aber den Titel nicht mehr frei verändern wenn man ihn auch als Bezeichnung für den Language Switcher nutezn möchte.
<html lang="<?= $user->language->title ?>">

'''Möglichkeit 3'''

Dies hat bei mir nicht funktioniert:
<pre>
<? $lang = $pages->get(1)->getLanguageValue($user->language, 'name'); ?>
<html lang="<?php echo $lang ?>">
</pre>
Hier wird einfach der Name der Sprache die der Benutzer im Moment hat (Session) ausgegeben. Der Name der Sprache sollte im Backend entsprechend der Norm gewählt sein. (de, it, fi...). Problem war das man den Namen der default Sprache nicht vergeben kann.

==== 4. Language Switcher ====
'''Text Navigation''' z.B. so:
<syntaxhighlight lang="php">
<?php namespace ProcessWire;

?>
<ul id="nav-lang" class="nav nav-h">
<?php
foreach($languages as $language){
if(!$page->viewable($language)) continue; // is page viewable in this language?
if($language->id == $user->language->id) {
echo "<li class='current'>";
} else {
echo "<li>";
}
$url = $page->localUrl($language);
$hreflang = $pages->get('/')->getLanguageValue($language, 'name');
echo '<a hreflang="'.$hreflang.'" href="'.$url.'" style="text-transform:uppercase;">'.$language->title.'</a></li>';
echo "</li>";
}
?>
</ul>
</syntaxhighlight>

=====Textnavigation mit first/last etc. Klassen=====

<syntaxhighlight lang="php">
<?php namespace ProcessWire;

?>
<ul id="nav-lang" class="nav nav-h">
<?php
$n = $languages->count();
$i = 0;

$separator = '<span class="separator">|</span>';
foreach($languages as $language){
$liClass = array();
if(!$page->viewable($language)) continue; // is page viewable in this language?
$i++;
if( $i == 1 ) $liClass[] = "first";
if( $i == $n ) $liClass[] = "last";
if($language->id == $user->language->id) $liClass[] = 'current';
echo '<li class="'.implode(' ',$liClass).'">';
$url = $page->localUrl($language);
$hreflang = $pages->get('/')->getLanguageValue($language, 'name');
echo '<a hreflang="'.$hreflang.'" href="'.$url.'" style="text-transform:uppercase;">'.$language->title.'</a></li>';
if( $i < $n ) echo $separator;
echo "</li>";
}
?>
</ul>
</syntaxhighlight>

=====Flaggennavi=====
z.B. so :
<syntaxhighlight lang="php">
<?php namespace ProcessWire;

?>
<ul id="nav-lang" class="">
<?php
foreach($languages as $language){
if(!$page->viewable($language)) continue; // is page viewable in this language?
if($language->id == $user->language->id) {

echo '<li class="current" style="opacity:0.5;">';
} else {
echo '<li>';
}
$flag = urls()->templates.'assets/flag-'.$language->name.'.png';
$url = $page->localUrl($language);
$hreflang = $pages->get('/')->getLanguageValue($language, 'name');
echo '<a hreflang="'.$hreflang.'" href="'.$url.'"><img class="flag" src="'.$flag.'" style="width: 100px;"></a></li>';
echo '</li>';
}
?>
</ul>
</syntaxhighlight>

===== Language Toggle Schiebeschalter =====
Siehe auch Codepen "Kholja"
<syntaxhighlight lang="html5">
<h2>Fixed width label</h2>

<div class="language-switcher-fixed">

<a href="/en" class="toggle-switch en" title="Wechsel zu Englisch">
<div class="switch">
<div class="knob"></div>
<div class="label">en</div>
</div>
</a>


<a href="/de" class="toggle-switch de" title="Wechsel zu Deutsch">
<div class="switch">
<div class="knob"></div>
<div class="label">de</div>
</div>
</a>
</div>

<h2>Dynamic width label</h2>
<div class="language-switcher-dynamic">

<a href="/de" class="toggle-switch de" title="Wechsel zu Deutsch">
<div class="switch">
<div class="knob"></div>
<span class="label">Deutsch</span>
</div>
</a>


<a href="/en" class="toggle-switch en" title="Wechsel zu Englisch">
<div class="switch">
<div class="knob"></div>
<span class="label">English</span>
</div>
</a>
</div>

</syntaxhighlight
<syntaxhighlight lang="scss">
$switch-background-color :#006B52;
$switch-background-color-hover: #4a9a14;
$label-color: #fff;
// $border-color: rgba(0,0,0,0.5);
$switch-border-color: #fff;
$knob-color: #006B52;
// $knob-border-color: rgba(0,0,0,0.5);
$knob-border-color: transparent;
$knob-background-color: #fff;
body{
font-family: Helvetica, sans-serif;
background: #006B52;
color: white;
}
h2{
text-align: center;
}
.language-switcher-fixed, .language-switcher-dynamic{
padding: 40px;
justify-content: center;
}
/* fixed width */
.language-switcher-fixed {
display: flex;
gap: 1rem;

.toggle-switch {
text-decoration: none;
display: inline-block;

.switch {
position: relative;
width: 64px;
height: 32px;
background-color: $switch-background-color;
border-radius: 16px;
border: 1px solid $switch-border-color;
transition: background-color 0.3s ease;
}

.knob {
position: absolute;
top: 3px;
width: 24px;
height: 24px;
background-color: $knob-background-color;
border-radius: 50%;
border: 1px solid $knob-border-color;
transition: all 0.3s ease;
}

.label {
position: absolute;
top: 50%;
transform: translateY(-50%);
font-size: 15px;
font-weight: bold;
text-transform: uppercase;
color: $label-color;
}
}

/* Deutscher Schalter: Knopf links, Beschriftung rechts */
.toggle-switch.de {
.knob {
left: 2px;
}
.label {
right: 8px;
}
}

/* Englischer Schalter: Knopf rechts, Beschriftung links */
.toggle-switch.en {
.knob {
right: 2px;
}
.label {
left: 8px;
}
}

/* Hover- und Active-Effekte */
.toggle-switch:hover .switch {
background-color: $switch-background-color-hover;
}
.toggle-switch:active .knob {
transform: scale(0.95);
}

}

/* dynamic width */
.language-switcher-dynamic {
display: flex;
gap: 1rem;
.toggle-switch {
text-decoration: none;
display: inline-block;

.switch {
display: inline-flex;
align-items: center;
border-radius: 21px;
border: 1px solid $switch-border-color;
background-color: $switch-background-color;
padding: 5px 10px;
transition: background-color 0.3s ease;
/* Die Breite passt sich automatisch an den Inhalt an */
}

.knob {
width: 26px;
height: 26px;
background-color: $knob-background-color;
border-radius: 50%;
box-shadow: 0 1px 3px rgba(0, 0, 0, 0.3);
transition: transform 0.3s ease;
flex-shrink: 0;
}

.label {
font-size: 0.9rem;
font-weight: bold;
color: $label-color;
margin: 0 5px;
text-transform: uppercase;
}
}

/* Deutscher Schalter: Knopf links, Label rechts */
.toggle-switch.de .switch {
flex-direction: row;
}

/* Englischer Schalter: Knopf rechts, Label links */
.toggle-switch.en .switch {
flex-direction: row-reverse;
}

/* Hover- und Active-Effekte */
.toggle-switch:hover .switch {
background-color: $switch-background-color-hover;
}

.toggle-switch:active .knob {
transform: scale(0.95);
}

}

</syntaxhighlight>

=== Prantner ===
Hauptnavigation mit Flaggen:

language-switcher.inc
<syntaxhighlight lang="php">
<?php namespace ProcessWire;
$imgMarkup = "";
$out = "";
foreach($languages as $language) {
if(!$page->viewable($language)) continue; // is page viewable in this language?
$url = $page->localUrl($language);
$hreflang = $homepage->getLanguageValue($language, 'name');
$imgUrl = $config->urls->templates.'assets/flags/'.$language->name.'_sq.png';
$imgMarkup = "<img src=\"$imgUrl\" title=\"$language->title\" alt=\"$language->title\" class=\"circle z-depth-1\">";
if($language->id == $user->language->id) {
$out .= "<span class=\"lang-button current\">";
} else {
$out .= "<span class=\"lang-button\">";
}
$out .= "<a hreflang=\"$hreflang\" href=\"$url\">$imgMarkup</a></span>";
}
$out = '<div id="nav-lang">'.$out.'</div>';
echo $out;
?>
</syntaxhighlight>

language-switcher-mobile.inc
<syntaxhighlight lang="php">
<?php namespace ProcessWire;
?>
<ul id="nav-mobile" class="right hide-on-med-and-down">
<?php
foreach($languages as $language) {
if(!$page->viewable($language)) continue; // is page viewable in this language?
if($language->id == $user->language->id) {
echo "<li class='current'>";
} else {
echo "<li>";
}
$url = $page->localUrl($language);
$hreflang = $homepage->getLanguageValue($language, 'name');
echo "<a hreflang='$hreflang' href='$url'>$language->title</a></li>";
}
?>
</ul>
</syntaxhighlight>

== Language Snippets ==
=== URL der Sprache ===
getLanguageValue($language->id, 'url');
$page->localHttpUrl($language->id);
$page->localUrl($language->id);

=== Field Label in aktueller Sprache ===
fields($f)->getLabel()
Wobei $f ein Feldname sein kann aber auch ein Feldobjekt.

ProcessWire - Multilanguage Website

2025-03-22T08:16:11Z

109.193.152.88: /* 4. Language Switcher */

ProcessWire - OAuth Anmeldung über Microsoft365

2025-03-17T10:49:01Z

109.193.152.88:

== Quickstart ==
# App bei EntraID registrieren
## Anwendungen
## ID und Secret werden in der Anwendung benötigt
## Urls festlegen (Redirect URL / Logout URL)
# User Template von ProcessWire erweitern. E-Mail und Passwort allein reicht nicht wir gleichen ab anhand:
## firstname
## lastname
## email (bereits vorhanden)

== Grundsätzliches Vorgehen ==

Azure App-Registrierung
Lege in der Azure App-Registrierung (Azure Active Directory) eine neue Anwendung an.
Richte die Umleitungs-URL (Redirect URI) ein, die später auf deine ProcessWire-Instanz zeigt (z. B. https://deinedomain.de/oauth/callback).
Notiere dir Client-ID und Client-Secret.

Authentifizierungsprotokoll auswählen
Microsoft Azure AD unterstützt sowohl OAuth2 als auch SAML.
Für die meisten Webanwendungen empfiehlt sich die OAuth2 / OpenID Connect-Variante. Damit erhält man später ein JWT (ID-Token bzw. Access-Token), das man in ProcessWire verifizieren kann.

Custom Module oder Integration in ProcessWire
Baue (oder nutze) ein eigenes ProcessWire-Modul, das sich um den OAuth-Flow kümmert. Typischerweise wird dazu nach Microsoft weitergeleitet (Login), und nach Erfolg wird man an die in Azure eingestellte Redirect-URL zurückgeleitet.
Im Modul muss das ID-Token (oder Access Token) validiert werden. Anschließend wird der Benutzer in ProcessWire identifiziert (z. B. anhand der E-Mail-Adresse).

Benutzer-/Rollenverwaltung
Bei erfolgreicher Anmeldung musst du entscheiden, ob ein ProcessWire-Benutzer angelegt wird, falls er noch nicht existiert, oder ob nur bestehende User eingelassen werden.
Ggfs. kannst du auch eine automatische Rollenzuordnung (z. B. role=editor oder role=client) machen, falls du anhand der Azure-AD-Gruppen oder der Domain („@meineDomain.com“) unterscheiden möchtest.

ProcessWire - OAuth Anmeldung über Microsoft365

2025-03-17T08:12:32Z

109.193.152.88:

== Quickstart ==
# App bei EntraID registrieren
## Anwendungen
## ID und Secret werden in der Anwendung benötigt

== Grundsätzliches Vorgehen ==

Azure App-Registrierung
Lege in der Azure App-Registrierung (Azure Active Directory) eine neue Anwendung an.
Richte die Umleitungs-URL (Redirect URI) ein, die später auf deine ProcessWire-Instanz zeigt (z. B. https://deinedomain.de/oauth/callback).
Notiere dir Client-ID und Client-Secret.

Authentifizierungsprotokoll auswählen
Microsoft Azure AD unterstützt sowohl OAuth2 als auch SAML.
Für die meisten Webanwendungen empfiehlt sich die OAuth2 / OpenID Connect-Variante. Damit erhält man später ein JWT (ID-Token bzw. Access-Token), das man in ProcessWire verifizieren kann.

Custom Module oder Integration in ProcessWire
Baue (oder nutze) ein eigenes ProcessWire-Modul, das sich um den OAuth-Flow kümmert. Typischerweise wird dazu nach Microsoft weitergeleitet (Login), und nach Erfolg wird man an die in Azure eingestellte Redirect-URL zurückgeleitet.
Im Modul muss das ID-Token (oder Access Token) validiert werden. Anschließend wird der Benutzer in ProcessWire identifiziert (z. B. anhand der E-Mail-Adresse).

Benutzer-/Rollenverwaltung
Bei erfolgreicher Anmeldung musst du entscheiden, ob ein ProcessWire-Benutzer angelegt wird, falls er noch nicht existiert, oder ob nur bestehende User eingelassen werden.
Ggfs. kannst du auch eine automatische Rollenzuordnung (z. B. role=editor oder role=client) machen, falls du anhand der Azure-AD-Gruppen oder der Domain („@meineDomain.com“) unterscheiden möchtest.

ProcessWire - OAuth Anmeldung über Microsoft365

2025-03-17T07:53:01Z

109.193.152.88: Die Seite wurde neu angelegt: „== Quickstart == # App bei EntraID registrieren ## Anwendungen ## ID und Secret werden in der Anwendung benötigt“

== Quickstart ==
# App bei EntraID registrieren
## Anwendungen
## ID und Secret werden in der Anwendung benötigt

Microsoft 365

2025-03-17T07:17:47Z

109.193.152.88:

== Quickstart ==
In 2023/2024 hat Microsoft die meisten Dienste unter dem Terminus Microsoft 365 zusammengefasst. Diese Seite soll als Startpunkt für die Suche dienen.

== Office auf dem Desktop installieren ==
Die Downloads sind oft schwer zu finden.

Hier geht es Stand März 2025:
* Einloggen auf https://www.microsoft365.com
* Home-Seite
* Oben rechts "Installieren und mehr" Button

== Was ist was ==
=== Admin Center ===
Zentrale Verwaltung, Billing, Benutzerverwaltung

=== Purview ===
Compliance Center

=== Azure / Entra ===
Azure AD heißt jetzt Entra.

=== Exchange ===
Postfächer etc.

=== Defender ===
Bedrohungen analysieren und reagieren

== Anmeldung ==
https://learn.microsoft.com/de-de/entra/identity/authentication/concept-authentication-methods - Einstieg
https://mysignins.microsoft.com/security-info // Self-Service Einstellungen

=== Mehrstufige Authentifizierung (MFA) ===
https://www.youtube.com/watch?v=qNndxl7gqVM
https://aka.ms/MFASetup - Benutzerregistrierung
https://go.microsoft.com/fwlink/?LinkId=627442 Handbuch
==== Telefon und E-Mail als Administrator festlegen ====
Entra Portal > Benutzer > B
=== Bedingter Zugriff ===
=== Kombinierte Anmeldung ===
Todo

=== Probleme ===
MFA wird erzwungen, obwohl sie deaktiviert ist.
Mögliche Gründe:
* Single Sign On
* Richtlinien für bedingten Zugriff - in Azure können extra Richtlinien unter bestimmten Bedingungen definiert sein (z.b. Anmeldung außerhalb des Unternehmensnetzwerks).
* Residuale Situationen (alte Richtlinien)
* Sicherheits (Compliance) Anforderungen Azure / Entra

== OAuth Anmeldung von externer App nutzen ==
Generell kann man externe kann man User externer Anwendungen anmelden. Dazu muss man eine App in EntraID registrieren.
=== ProcessWire User über OAuth ===
[[ProcessWire - OAuth Anmeldung über Microsoft365]]

Microsoft 365

2025-03-14T08:51:24Z

109.193.152.88:

ProcessWire - Navigation Snippets

2025-03-07T11:58:26Z

109.193.152.88: /* Breadcrumb */

== TODO Seite aufräumen ==
== Siehe auch ==
[[Processwire Module: MarkupSimpleNavigation]] automatisch Navigation aus Seitenbaum erstellen
[[Aligator (ProcessWire)]] - automatische Navigation, gut wenn manipuliert werden muss.
[[Menu Builder (ProcessWire)]] - Menüs im Backend erstellen (Wordpress like)

== Navigation in Pagewire - Einführung ==
=== Navigationstypen allgemein ===
Es gibt verschiedene '''Typen von Navigationen'''. In Processwire hat man ein '''Pages Objekt''', indem auch Zugriff auf Kind- und Elternseiten möglich sind. Es bildet also immer die Sitestruktur ab. Daher übergibt man an die unten aufgeführten Funktionen entweder die Homepage oder die aktuelle Seite.

Unter dem Aspekt auf welcher Seite man sich befindet kann man unterscheiden zwischen:
* '''absolute Navigation''' normalerweise ausgehend von der Rootseite. diese ist dann auf allen Seiten gleich.
** z.B. alle Seiten des ersten Levels stehen in der Hauptnavigation egal auf welcher Seite ich im Moment bin
** z.B. verschachtelte Liste mit 2 oder mehr Leveln für Dropdown Navigationen wie Superfish, Megamenüs (mit zusätzlichen Infos...) oder Bootstrap Navigationen.
** Sitemap
* '''Navigation relativ zur Seite''' Diese kann sich von Seite zu Seite unterscheiden.
** Alle '''Seiten der aktuellen Ebene''' (oft kombiniert mit Breadcrumb / Hier-bin-ich) )
** Hauptebene '''und''' aktueller Level
** Alle Ebenen '''bis zur aktuellen Seite + deren Unterseiten''' falls vorhanden.
In letzten Fall könnte man auch Varianten bauen in denen eine Verschachtelte Liste erzeugt wird aber nur bestimmte Teile absolut Positioniert angezeigt werden und andere versteckt werden. Manchmal möchte man bestimmte Level aber auch an anderer Position zeigen (z.B. Sidebar)
In der Praxis hat man in der Regel
* Mindestens eine Hauptnavigation mit allen Seiten der 1. Ebene oder eine Hauptnavigation mit mehreren Ebenen für Dropdown Navigationen, mobile Navigation oder auch Sitemapartige Navigationen für den Footer (oft mit kleinen Beschreibungen).
* Eine Metanavigation mit Service Seiten wie Kontakt, Impressum etc. oft ist diese im Footer.

=== Unterschiede zwischen Verstecken, Veröffentlichen, Sperren ===
In Processwire sind diese Begriffe mit Userrechten verknüpft. Eine unveröffentlichte Seite kann also durchaus im Frontend aufgerufen werden (es sei denn man regelt das anders.) Vielmehr geht es darum das man User Rollen so gestalten kann, dass man z.B. einem User nur erlaubt unveröffentlichte Seiten zu editieren.

Denoch gibt es auch ein paar weitere Unterschiede.

Gesperrt -> Man kann die Seite nicht zum Editieren aufrufen. Über die Url kann Sie aufgerufen werden.

Unpublished -> Die Seite kann sobald sie gespeichert ist auch aufgerufen werden, WENN der User berechtigt ist. Nicht für Guest User (der normale Viewer)

TODO checken ob die Tabelle so für nicht angemeldete User stimmt.
{| class="wikitable"
|-
! !! Im Menü ($pages->find) !! Über URL erreichbar($pages->get) !! Ausgabe im Frontend !!
|-
| Unpublished / Unveröffentlicht || Nein || Nur User mit passenden Rechten. Gäste -> leere Seite ||
|-
| Hidden / Versteckt || Nein || Ja || Ja - leere Seite (keine Feldausgabe)
|-
| Locked / Gesperrt || Ja || Ja || Ja
|-
| Trash || Nein || Nein ||
|}
==== Seiten auf unveröffentlicht stellen ====
https://processwire.com/talk/topic/29-how-to-unpublish-a-page-without-deleting-it/

Was soll man tun wenn man eine Seite tatsächlich nicht mehr anzeigen will, sie aber noch nicht wegwerfen will?
Ryan schlägt folgendes vor:
* Mülleimer
* Remove Guest Role in Template
*

== Basics ==
=== Minimal Navigation Bar ===
Aus dem Standard Template
<syntaxhighlight lang="php">
<?php
$homepage = $pages->get("/");
$navigation = $homepage->and($homepage->children)->implode(" / ", "<a href='{url}'>{title}</a>");
?>
<p id="topnav">
<?= $navigation ?>
</p>
</syntaxhighlight>

=== Basic Navigation ===
<syntaxhighlight lang="php">
<?php
// get the homepage object
$homepage = $pages->get("/");
// get PageArray of homepage object and child page objects
$navItems = $homepage->and($homepage->children);
?>
Now you have a PageArray with the required items, you can iterate over them one at a time, and print the title of the page and the link to the page itself and wrap the whole thing in your list tag.

<ul class="nav">

<?php
// get the homepage object
$homePage = $pages->get("/");
// get PageArray of homepage object and child page objects
$navItems = $homePage->and($homePage->children);
// or if you don't want the home link
// $navItems = $homePage->children;
// iterate over the $navItems PageArray
foreach ($navItems as $navItem):
?>

<li class="nav-item">
<a class="nav-link" href="<?php echo $navItem->url; ?>"><?php echo $navItem->title; ?></a>
</li>

<?php endforeach; ?>

</ul>
</syntaxhighlight>

==== Basic mit active Class ====
<syntaxhighlight lang="php">
<ul class="nav">

<?php
// get the homepage object
$homePage = $pages->get("/");
// get PageArray of homepage object and child page objects
$navItems = $homePage->and($homePage->children);
// or if you don't want the home link
// $navItems = $homePage->children;
// iterate over the $navItems PageArray
foreach ($navItems as $navItem):

// if the id of the page currently being
// iterated equals the id of the current page
$activeClass = ($navItem->id == $page->id) ? " active" : "";
?>

<li class="nav-item">
<a class="nav-link<?php echo $activeClass; ?>" href="<?php echo $navItem->url; ?>"><?php echo $navItem->title; ?></a>
</li>

<?php endforeach; ?>

</ul>
</syntaxhighlight>

==== Child Menu ====
<syntaxhighlight lang="php">

<ul class="sub-menu">

<?php
// get children of the parent of the current page
$childPages = $page->parent->children;

// iterate over the $navItems PageArray
foreach ($childPages as $childPage):

// if the id of the page currently being
// iterated equals the id of the current page
$activeClass = ($navItem->id == $page->id) ? " active" : "";
?>

<li class="nav-item">
<a class="nav-link<?php echo $activeClass; ?>" href="<?php echo $childPage->url; ?>"><?php echo $childPage->title; ?></a>
</li>

<?php endforeach; ?>

</ul>
</syntaxhighlight>

=== Page Level ===
In which level in page tree we are?
$level = count($page->parents);

=== Parent, active parent ===
$isParent = $item->hasChildren;
$isActiveParent = $item->child('id='.$page->id)->id; // Seite ist in Rootline wenn sie ein aktives Kind hat

=== Link to Subpage und Platzhalter (Spacer) ===
Kann man gut für Superfish Menüs etc. benutzen. Bildet das Verhalten von Shortcuts und Spacern aus TYPO3 nach.

Anpassung der renderNavTree() Funktion von Ryan Cramer. Options Field Installieren und als globales Feld "navigation_type" mit den Optionen
<pre>
1=normal|Normal
2=doNotLink|Do not link
3=linkToFirstChild|Link to first childpage
</pre>
konfigurieren. Dann Funktion etwa so anpassen:
<pre>
...
// cycle through all the items
foreach($items as $item) {

// markup for the list item...
// if current item is the same as the page being viewed, add a "current" class to it
$out .= $item->id == wire('page')->id ? "<li class='current'>" : "<li>";

// markup for the link
$navigation_type = $item->navigation_type->id;
switch ( $navigation_type ) {
case 2: // do not link
$out .= "<span class='spacer'>$item->title</span>";
break;
case 3: // link to subpage
if( $item->hasChildren() ){
$out .= '<a href="'.$item->child->url.'">'.$item->title.'</a>';
}else{
$out .= "<span class='spacer'>$item->title</span>";
}
break;
default:
$out .= "<a href='$item->url'>$item->title</a>";
break;
}
...
</pre>

=== Redirect (301) ===
==== Redirect zu erster Unterseite ====
https://processwire.com/talk/topic/15-how-do-i-create-a-page-that-redirects-to-its-first-child/

Field ''redirects_to_first_child'' erstellen und im Template einfügen.
<syntaxhighlight lang="php">
<?php
if($page->numChildren && $page->redirects_to_first_child)
$session->redirect($page->child()->url);
?>
</syntaxhighlight>
Erzeugt 301 Weiterleitung

Anderer Ansatz wäre evtl. den Link bei der Menügenerierung direkt zu generieren. finde ich persönlich besser siehe ''Link to subpage und Platzhalter'' Beispiel. Allerdings sollte man dann vielleicht die Seite trotzdem per 301 Weiterleiten, falls die URL mal direkt aufgerufen wird oder bei Google gelistet ist.

==== Redirect zu anderer Seite in der Navigation ====
https://processwire.com/talk/topic/762-howto-menu-item-that-links-to-another-page/

1. Create a new field and call it 'redirect_url' or something like that, and use the 'URL' fieldtype.

2. Add that field to your template where you'd want to use it, or create a new template just for the purpose, like a template named 'redirect'.

3. Edit the page that you want to be a symlink and populate the 'redirect_url' field with the URL you want it to redirect to.

4. In your nav-generation code that links to the pages, do something like this:

<syntaxhighlight lang="php">
<?php
$url = $subpage->get("redirect_url|url"); // use redirect_url if there, otherwise use url
echo "<a href='$url'>{$subpage->title}</a>";
</syntaxhighlight>
5. You might also want to add this to your template that has the 'redirect_url' field: just in case there's anything linking to it directly. That way it'll send people to the right place either way:

<?php
if($page->redirect_url) $session->redirect($page->redirect_url);

=== Breadcrumb ===
<syntaxhighlight lang="php">

<div class='breadcrumbs'>
<?php
// breadcrumbs are the current page's parents
foreach($page->parents() as $item) {
echo "<span><a href='$item->url'>$item->title</a></span> ";
}
// optionally output the current page as the last item
echo "<span>$page->title</span> ";
?>
</div>
</syntaxhighlight>

=== One Level Navigation Bar ===
[[ProcessWire - One Level Navigation]]
=== Nächste Seite / Next Page Navigation ===
Beispiel 1
<syntaxhighlight lang="php">
if($page->next->id){
$next = '
<div class="next">
<i>Next:</i> 
<a class="ajax-link" name="'.$page->next->title.'" href="'. $page->next->url .'">
'. $page->next->title .'<span class="fa fa-arrow-right"><span>
</a>
</div>';
}
</syntaxhighlight>

Beispiel 2 (mit zurück zur Elternseite)
<syntaxhighlight lang="php">
$next = '';
if($page->next->id){
$next = '
<a href="'.$page->next->url.'">
<i class="fa fa-angle-right"></i>
</a>
';
}

$prev = '';
if($page->prev->id){
$prev = '
<a href="'.$page->prev->url.'" class="w-inline-block paginaton-but">
<i class="fa fa-angle-left"></i>
</a>';
}

$pagination = '
<div class="container pagination">
<div class="row">

<div class="col col-md-4">
<div class="align-center">
'.$prev.'
</div>
</div>

<div class="col col-md-4">
<div class="align-center">
<a href="'.$page->parent->url.'">
<i class="fa fa-th"></i>
</a>
</div>
</div>

<div class="col col-md-4">
<div class="align-right center">
'.$next.'
</div>
</div>
</div>

</div>
';

echo $pagination;
</syntaxhighlight>

=== Zurück zur Elternseite ===
<syntaxhighlight lang="php">
<div class="back"><a href="'.$page->parent()->url.'">zurück</a></div>
</syntaxhighlight>

=== Kindseiten mit $page->children ===
<?=$page->children?>
Output
5723,4958,5937

Beispiel
<syntaxhighlight lang="php">
<ul>
<?php
foreach($page->children as $child)
echo "<li><a href='{$child->url}'>{$child->title}</a></li>";
?> 
</ul>
</syntaxhighlight>
Ergebnis:
<pre>
<ul> 
<li><a href='/about/contact/'>Contact Us</a></li>
<li><a href='/about/press/'>Press Releases</a></li>
<li><a href='/about/staff/'>Our Staff</a></li> 
</ul>
</pre>
=== Children Tree ===
<syntaxhighlight lang="php">
function listChildrenTree($children, $current, $w) {

echo "<ul>";

foreach($children as $page) {

$class = '';
if($page === $current || $current->parents->slice(1)->has($page) ) {
$class = "class='on' style='font-weight:bold'";
}

$rootid = $w->pages->get("/")->id;

echo "<li><a href='{$page->url}' $class>";
if($page->id == $rootid) echo "<img src='" . $w->config->urls->templates . "styles/images/home.png' width='24' height='28' alt='' />";
echo "{$page->title}</a> ";

if($page->numChildren && $page->id != $rootid) listChildrenTree($page->children, $current, $w);

echo "</li>";
}
echo "</ul>";
}

$children = $pages->get("/")->children();
$children->prepend($pages->get("/"));

listChildrenTree($children, $page, $wire);
</syntaxhighlight>

== Bootstrap Navigation ==
<syntaxhighlight lang="php">
<?php namespace ProcessWire;
// Markup to use wicht navigation_type field (normal=1, no-link=2,subpage=3)
?>

<?php

// bundle up the first level pages and prepend the root home page
$homepage = $pages->get(1);
$pa = $homepage->children;
$pa = $pa->prepend($homepage);

// Set the ball rolling...
$myMenu = renderChildrenOf($pa);
$wrapper = '
<nav class="navbar navbar-default">
<div class="container-fluid">
<div class="navbar-header">
<button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#navbar-collapse-1" aria-expanded="false">
<span class="sr-only">Menü</span>
<span class="icon-bar"></span>
<span class="icon-bar"></span>
<span class="icon-bar"></span>
</button>
</div>
<div class="collapse navbar-collapse" id="navbar-collapse-1">
|
</div>
</div>
</div>';
$myMenu = wrap($myMenu,$wrapper);
echo $myMenu;

/*
Navigation for ProcessWire using the Bootstrap 2.2.2 markup
This menu was written by Soma based on work by NetCarver and a bit thrown in by Joss
Bootstrap 3 update by Damienov, with multi level dropdown support fix
*/
function renderChildrenOf($pa, $output = '', $level = 0)
{
$output = '';
$level++;

foreach ($pa as $child) {
$atoggle = '';
$class = '';

if ($child->numChildren && count($child->parents) == 1) {
$class .= 'dropdown';
$atoggle .= ' class="dropdown-toggle" data-toggle="dropdown"';
} else if ($child->numChildren && count($child->parents) > 1 ) {
$class .= 'dropdown-submenu';
$atoggle .= ' class="dropdown-toggle"';
} else if ($child->numChildren && $child->id != 1) {
$class .= 'dropdown-menu';
}

// Makes the current page and it's top level parent add an active class
$class .= ($child === wire("page") || $child === wire("page")->rootParent) ? " active" : '';
$class = strlen($class) ? " class='" . trim($class) . "'" : '';

if ($child->numChildren && count($child->parents) == 1) {
// Add Caret if have children
$output .= "<li$class><a href='$child->url'$atoggle>$child->title <b class='caret'></b></a>";
} else if ($child->numChildren && count($child->parents) > 1) {
$output .= "<li$class><a tabindex='-1' href='$child->url'$atoggle>$child->title</a>";
} else {
$output .= "<li$class><a href='$child->url'$atoggle>$child->title</a>";
}

// If this child is itself a parent and not the root page, then render it's children in their own menu too...
if ($child->numChildren && $child->id != 1) {
$output .= renderChildrenOf($child->children, $output, $level);
}
$output .= '</li>';
}
$outerclass = ($level == 1) ? "nav navbar-nav" : 'dropdown-menu';
return "<ul class='$outerclass'>$output</ul>";
}

?>
</syntaxhighlight>

== Modul: MarkupSimpleNavigation==
[[Processwire Modul - MarkupSimpleNavigation]]

== Weitere Menübeispiele ==
=== Flexible Funktion zum erzeugen von Tree oder Listen Navigationen ===
//Todo fix depth (siehe MenuShifter Modul)
* ul-Liste oder nur li
* Rendertiefe einstellbar
* Page Objekt von dem Kinder gerendert werden oder PageArray
* Filter (Selector) für Kindobjekte.
* Root voranstellen oder auch nicht (z.B. für Homepage)

<syntaxhighlight lang="php">
/**
* Rendert eine Navi. Kindseiten wenn eine Page übergeben wird.
* Alle Seiten inkl. Kinder wenn ein PageArray übergeben wird.
*
*/
function nav($items,$options = array()){
static $depth = 0;
$defaults = array(
'ul' => true, // wrap in <ul> or not
'class' => '', // class for ul
'depth' => 1, // render depth
'selector' => '', // filters child elements
'prependRoot' => false // if you provide a Page (i.e. home), prepend as menu item
);
$options = array_merge($defaults, $options);
$page = $items->wire('page'); // current page
$class = $depth ? "nav-sub" : rtrim("nav $options[class]");
$attr = rtrim("class='$class'");
$out = $options['ul'] ? "<ul $attr>" : "";
// if given a Page use children as the items and use Page as the header
// if given a page array use each Page as the items
if($items instanceof Page) {
//$header = $items;
if($options['prependRoot']) $out .= "<li class='root'> <a href='$items->url'>$items->title</a></li>";
$items = $items->children($options['selector']);
}
if(!$items->count) return '';

foreach($items as $n => $item) {
$isParent = $options['depth'] && $item->hasChildren && $depth < $options['depth'];
$classes = array();

// determine additional classes
if($item->id == $page->id) $classes[] = 'active';
if($isParent) $classes[] = 'parent';

// open the list item
$out .= count($classes) ? "<li class='" . implode(' ', $classes) . "'>" : "<li>";
$out .= "<a href='$item->url'>$item->title</a>";
// see if we are working with a nested list and go recursive if so
if($isParent) {
$depth++;
$children = $item->children($options['selector']);
$out .= nav($children, array(
'depth' => $options['depth'],
'selector' => $options['selector']
));
$depth--;
}

// close the list item
$out .= "</li>";
}
if($options['ul']) $out .= "</ul>";
return $out;
}
</syntaxhighlight>

=== Standard Tree Navigation ===
Für viele Zwecke ausreichend und leicht anpassbar, die klassische verschachtelte Liste.

=== Menüauswahl Hauptmenü / Metamenü / Footer-Navigation ===
Beispiel 1
Backend Feld menus anlegen Options:

1=Main Menu
2=Meta Menu

topnav.inc
<syntaxhighlight lang="php">
$pa = $homepage->and($homepage->children("menus.id=1"));//only if main menu is checked
$options = array('level' => '1', 'ulClass' => 'sf-menu', 'liClass' => '');
echo "<div>".renderNavTreeType($pa, $maxDepth = 1, $fieldNames = '', $options)."</div>";
</syntaxhighlight>

'''Beispiel 2 (älter)'''

Checkbox anlegen (footer_nav), und dann das Seitenarray etwa so modifizieren.
<pre>
$footer_nav = $pages->find("parent=1, footer_checkbox=1");
$main_nav = $pages->find("parent=1, footer_checkbox!=1");
</pre>

=== Zweispaltige Navigation aus Kindseiten ===
Verbesserungsvorschlag: Anstatt if lieber zwei for Schleifen -> bessere Performance
<syntaxhighlight lang="php">
// Childrens
$n = count($page->children);
$m = ceil($n/2);
$c = 0;

// NAVIGATION & SLIDER Items
$listItem = '';
$navList = '';
$col1 = '<ul class="nav-list col1">';
$col2 = '<ul class="nav-list col2">';
foreach ($page->children as $item) {
if($item->id == $page->rootParent->id) {
$listItem = '<li class="current">';
} else {
$listItem = '<li>';
}
$listItem .= '<a class="ajax-link" href="'.$item->url.'">'.$item->title.'</a></li>';
($c < $m) ? $col1 .= $listItem : $col2 .= $listItem;
$c++;
}
$col1 .= '</ul>';
$col1 .= '</ul>';
$navList = $col1.$col2;
</syntaxhighlight>

Mehrspaltige Navigationen lassen sich auch mit der slice Funktion erstellen:

<syntaxhighlight lang="php">
$categories = $pages->get('/about/sites/categories/')->children();
foreach($categories->slices(3) as $items) {
echo "<div class='uk-width-1-3'><ul>";
echo $items->each("<li><a href='{url}'>{title}</a>");
echo "</ul></div>";
}
</syntaxhighlight>

=== Pushy Menu ===
<syntaxhighlight lang="php">
/**
* Given a group of pages, render a <ul> navigation tree
*
* This is here to demonstrate an example of a more intermediate level
* shared function and usage is completely optional. This is very similar to
* the renderNav() function above except that it can output more than one
* level of navigation (recursively) and can include other fields in the output.
* Assumes there is a field navigation_type to decide how a list item is
* rendered
*
* @param array|PageArray $items
* @param int $maxDepth How many levels of navigation below current should it go?
* @param string $fieldNames Any extra field names to display (separate multiple fields with a space)
* @param array $options extra options for classes configuration etc.
* @return string
*
*/
function renderPushyMenu($items, $maxDepth = 0, $fieldNames = '', $options = array('level' => 0, 'ulClass' => '', 'liClass' => '', 'aClass' => '') ) {

// if we were given a single Page rather than a group of them, we'll pretend they
// gave us a group of them (a group/array of 1)
if($items instanceof Page) $items = array($items);
$out = '';
$c = 0;
$liClasses = array();
$ulClasses = array();
$level = 0;
$liClass = '';
$ulClass = '';

if(!empty($options['level'])) $level = $options['level'];
if(!empty($options['ulClass'])) {
$ulClasses[] = $options['ulClass'];
$ulClass = $options['ulClass'];
}

if(!empty($options['liClass'])) {
$liClasses[] = $options['liClass'];
$liClass = $options['liClass'];
}

// cycle through all the items
foreach($items as $item) {
//$level = count($page->parents);
// LI ITEM
$classes = $liClasses;
//if($item->id == wire('page')->id) $classes[] = 'cur';
if($item->hasChildren) {
// BUTTON instead of Link
$out .= '<li class="pushy-submenu"><button>'.$item->title.'</button>';
}else{
$classes[] = 'level-'.$level;
$out .= '<li class="'.implode($classes,' ').'">';
unset($classes);

// A ITEM
$navigation_type = $item->navigation_type->id;
$classes = $liClasses;
switch ( $navigation_type ) {
case 2: // do not link
$out .= '<span class="spacer">'.$item->title.'</span>';
break;
case 3: // link to subpage
if( $item->hasChildren() ){
$out .= '<a href="'.$item->child->url.'" class="ajax-link">'.$item->title.'</a>';
}else{
$out .= "<span class='spacer'>$item->title</span>";
}
break;
default:
$out .= '<a href="'.$item->url.'" class="ajax-link">'.$item->title.'</a>';
break;
}
unset($classes);
}
// if there are extra field names specified, render markup for each one in a <div>
// having a class name the same as the field name
if($fieldNames) foreach(explode(' ', $fieldNames) as $fieldName) {
$value = $item->get($fieldName);
if($value) $out .= " <div class='$fieldName'>$value</div>";
}

// if the item has children and we're allowed to output tree navigation (maxDepth)
// then call this same function again for the item's children
if($item->hasChildren() && $maxDepth) {
//if($class == 'nav') $class = 'nav nav-tree';
$nextLevelOptions = array('level' => $level+1, 'ulClass' => '', 'liClass' => $liClass);
$out .= renderNavTreeType($item->children, $maxDepth-1, $fieldNames, $nextLevelOptions);
}

// close the list item
$out .= "</li>\n";
}

// if output was generated above, wrap it in a <ul>

if($out) $out = "\n".'<ul class="'.implode($ulClasses,' ').'">'."\n".$out.'</ul>'."\n";

// return the markup we generated above
return $out;
}

</syntaxhighlight>

== Do not link / link to subpage ==
=== MarkupSimpleNavigation XTemplate + Redirect Beispiel ===

https://github.com/s...default-options

'''Menü Platzhalter'''
<syntaxhighlight lang="php">
"xtemplate" => "folder|placeholder", // specify one or more templates
"xitem_tpl" => "<span>{title}</span>", // default markup for page with this template
"xitem_current_tpl" => "<span>{title}</span>"
echo $nav->render(array(
'max_levels'=>2,
'selector'=>"limit=10",
'xtemplates' => 'placeholder|folder'
));
</syntaxhighlight>

'''Redirect Template'''

You could also have a template "redirect" with only a title and a page field (single page) to select any page you want to go.

Then in the code you should be able to write
<syntaxhighlight lang="php">
array('item_tpl' => '<a href="{redirect_page|url}">{title}</a>')
</syntaxhighlight>
So it would take the url of the referenced page in the page field if found, or if not it takes the url of the page itself. Assuming the page field is named "redirect_page".

=== In der Navi ===
Zusätzliches Feld (Options) im Backend mit Namen navigation_type

Beispiel
<syntaxhighlight lang="php">
/**
* Given a group of pages, render a <ul> navigation tree
* If there is a field navigation_type the vals have following meaning
* 1 = Normal
* 2 = Do not link
* 3 = Link to subpage
*
* @param array|PageArray $items
* @param int $maxDepth How many levels of navigation below current should it go?
* @param string $fieldNames Any extra field names to display (separate multiple fields with a space)
* @param string $class CSS class name for containing <ul>
* @return string
*
*/
function renderNavTreeType($items, $maxDepth = 0, $fieldNames = '', $options = array('level' => 0, 'ulClass' => 'nav', 'liClass' => '', 'aClass' => '') ) {

// if we were given a single Page rather than a group of them, we'll pretend they
// gave us a group of them (a group/array of 1)
if($items instanceof Page) $items = array($items);

// $out is where we store the markup we are creating in this function
$out = '';
$c = 0;
$liClasses = array();
$ulClasses = array();
$level = 0;
$liClass = '';
$ulClass = '';

if(!empty($options['level'])) $level = $options['level'];
if(!empty($options['ulClass'])) {
$ulClasses[] = $options['ulClass'];
$ulClass = $options['ulClass'];
}

if(!empty($options['liClass'])) {
$liClasses[] = $options['liClass'];
$liClass = $options['liClass'];
}

// cycle through all the items
foreach($items as $item) {
//$level = count($page->parents);
// LI ITEM
$classes = $liClasses;
if($item->id == wire('page')->id) $classes[] = 'cur';
if($item->hasChildren) $classes[] = 'has_children';
$classes[] = 'level-'.$level;
$out .= '<li class="'.implode($classes,' ').'">';
unset($classes);

// markup for the link
$navigation_type = $item->navigation_type->id;
$classes = $liClasses;
switch ( $navigation_type ) {
case 2: // do not link
$out .= '<span class="spacer">'.$item->title.'</span>';
break;
case 3: // link to subpage
if( $item->hasChildren() ){
$out .= '<a href="'.$item->child->url.'" class="ajax-link">'.$item->title.'</a>';
}else{
$out .= "<span class='spacer'>$item->title</span>";
}
break;
default:
$out .= '<a href="'.$item->url.'" class="ajax-link">'.$item->title.'</a>';
break;
}
unset($classes);
// if there are extra field names specified, render markup for each one in a <div>
// having a class name the same as the field name
if($fieldNames) foreach(explode(' ', $fieldNames) as $fieldName) {
$value = $item->get($fieldName);
if($value) $out .= " <div class='$fieldName'>$value</div>";
}

// if the item has children and we're allowed to output tree navigation (maxDepth)
// then call this same function again for the item's children
if($item->hasChildren() && $maxDepth) {
//if($class == 'nav') $class = 'nav nav-tree';
$nextLevelOptions = array('level' => $level+1, 'ulClass' => '', 'liClass' => $liClass);
$out .= renderNavTreeType($item->children, $maxDepth-1, $fieldNames, $nextLevelOptions);
}

// close the list item
$out .= "</li>\n";
}

// if output was generated above, wrap it in a <ul>

if($out) $out = "\n".'<ul class="'.implode($ulClasses,' ').'">'."\n".$out.'</ul>'."\n";

// return the markup we generated above
return $out;
}
</syntaxhighlight>

=== Redirect über das Template ===
Sinnvoll wenn die URL direkt aufgerufen wird:

$session->redirect($page->redirect_page->url);
or how about "redirect-to-firstchild".

$session->redirect($page->children->first()->url);

== Beispiele für Funktionen (z.B. in _func.php)==
=== Externe Links finden ===
<syntaxhighlight lang="php">
public function isExternalLink($url) {
foreach($this->config->httpHosts as $hostname) {
// If the target host is one of our own hostnames,
// this link is not external.
if(preg_match("~^https?://{$hostname}~i", $url)) return false;
}

// Otherwise, all http(s) links are definitely external
// and get redirected.
if(preg_match('~^https?://~i', $url)) return true;

// No match, then we have a relative url (internal) or some other
// scheme (e.g. mailto) that we don't redirect.
return false;
}
</syntaxhighlight>
'''Beispiele für Funktionen die Navigationen erzeugen. '''
=== One Level ===
==== Original ProcessWire Demo Beispiel ====

=== Nested List ausgehend von einer Seite (meistens Homepage) ===
<syntaxhighlight lang="php">
<?php namespace ProcessWire;

/**
* Given a group of pages, render a ONE LEVEL NAVBAR
*
* @param array|PageArray $items
* @return string
*
*/
function renderNavMain($pa,$pageId){
if($pa instanceof Page) $pa = array($pa);
$out = '<nav class="menu menu--ferdinand"><ul class="nav navbar-nav menu__list">';
foreach($pa as $item) {
if($item->id == $pageId) {
$out .= "<li class=\"menu__item menu__item--current cur\">";
} else {
$out .= "<li class=\"menu__item\">";
}
// if template isotope-parent add first isotope-child name as hash
if($item->template->name == 'isotope-parent'){
$out .= '<a class="menu__link" href="'.$item->url.'#'.$item->child->name.'">'.$item->title.'</a></li>';
}else $out .= '<a class="menu__link" href="'.$item->url.'">'.$item->title.'</a></li>';
}
$out .= "</ul></nav>";
return $out;
}

/**
* Given a group of pages render a standard ISOTOP MARKUP
*
* @param array|PageArray $items
* @return string
*
*/
function renderNavIsotope($pa){
if($pa instanceof Page) $pa = array($pa);
$out = '<ul class="submenu">';
foreach($pa as $item){
$out .= '<li><a href="#'.$item->name.'" class="isotope-link">'.$item->title.'</a></li>';
}
$out .= "</ul>";
return $out;
}

/**
* Given a group of pages, render a simple <ul> navigation
*
* This is here to demonstrate an example of a simple shared function.
* Usage is completely optional.
*
* @param PageArray $items
* @return string
*
*/
function renderNav(PageArray $items) {

// $out is where we store the markup we are creating in this function
$out = '';

// cycle through all the items
foreach($items as $item) {

// render markup for each navigation item as an <li>
if($item->id == wire('page')->id) {
// if current item is the same as the page being viewed, add a "current" class to it
$out .= "<li class='current'>";
} else {
// otherwise just a regular list item
$out .= "<li>";
}

// markup for the link
$out .= "<a href='$item->url'>$item->title</a> ";

// if the item has summary text, include that too
if($item->summary) $out .= "<div class='summary'>$item->summary</div>";

// close the list item
$out .= "</li>";
}

// if output was generated above, wrap it in a <ul>
if($out) $out = "<ul class='nav'>$out</ul>\n";

// return the markup we generated above
return $out;
}

/**
* Given a group of pages, render a <ul> navigation tree
*
* This is here to demonstrate an example of a more intermediate level
* shared function and usage is completely optional. This is very similar to
* the renderNav() function above except that it can output more than one
* level of navigation (recursively) and can include other fields in the output.
*
* @param array|PageArray $items
* @param int $maxDepth How many levels of navigation below current should it go?
* @param string $fieldNames Any extra field names to display (separate multiple fields with a space)
* @param string $class CSS class name for containing <ul>
* @return string
*
*/
function renderNavTree($items, $maxDepth = 0, $fieldNames = '', $class = 'nav') {

// if we were given a single Page rather than a group of them, we'll pretend they
// gave us a group of them (a group/array of 1)
if($items instanceof Page) $items = array($items);

// $out is where we store the markup we are creating in this function
$out = '';

// cycle through all the items
foreach($items as $item) {

// markup for the list item...
// if current item is the same as the page being viewed, add a "current" class to it
$out .= $item->id == wire('page')->id ? "<li class='current'>" : "<li>";

// markup for the link
$out .= "<a href='$item->url'>$item->title</a>";

// if there are extra field names specified, render markup for each one in a <div>
// having a class name the same as the field name
if($fieldNames) foreach(explode(' ', $fieldNames) as $fieldName) {
$value = $item->get($fieldName);
if($value) $out .= " <div class='$fieldName'>$value</div>";
}

// if the item has children and we're allowed to output tree navigation (maxDepth)
// then call this same function again for the item's children
if($item->hasChildren() && $maxDepth) {
if($class == 'nav') $class = 'nav nav-tree';
$out .= renderNavTree($item->children, $maxDepth-1, $fieldNames, $class);
}

// close the list item
$out .= "</li>";
}

// if output was generated above, wrap it in a <ul>
if($out) $out = "<ul class='$class'>$out</ul>\n";

// return the markup we generated above
return $out;
}

</syntaxhighlight>

== Komplette Beispiele ==
[[ProcessWire - Navigation Beispiele]]

ProcessWire - Navigation Snippets

2025-03-07T11:57:03Z

109.193.152.88: /* Basics */

== TODO Seite aufräumen ==
== Siehe auch ==
[[Processwire Module: MarkupSimpleNavigation]] automatisch Navigation aus Seitenbaum erstellen
[[Aligator (ProcessWire)]] - automatische Navigation, gut wenn manipuliert werden muss.
[[Menu Builder (ProcessWire)]] - Menüs im Backend erstellen (Wordpress like)

== Navigation in Pagewire - Einführung ==
=== Navigationstypen allgemein ===
Es gibt verschiedene '''Typen von Navigationen'''. In Processwire hat man ein '''Pages Objekt''', indem auch Zugriff auf Kind- und Elternseiten möglich sind. Es bildet also immer die Sitestruktur ab. Daher übergibt man an die unten aufgeführten Funktionen entweder die Homepage oder die aktuelle Seite.

Unter dem Aspekt auf welcher Seite man sich befindet kann man unterscheiden zwischen:
* '''absolute Navigation''' normalerweise ausgehend von der Rootseite. diese ist dann auf allen Seiten gleich.
** z.B. alle Seiten des ersten Levels stehen in der Hauptnavigation egal auf welcher Seite ich im Moment bin
** z.B. verschachtelte Liste mit 2 oder mehr Leveln für Dropdown Navigationen wie Superfish, Megamenüs (mit zusätzlichen Infos...) oder Bootstrap Navigationen.
** Sitemap
* '''Navigation relativ zur Seite''' Diese kann sich von Seite zu Seite unterscheiden.
** Alle '''Seiten der aktuellen Ebene''' (oft kombiniert mit Breadcrumb / Hier-bin-ich) )
** Hauptebene '''und''' aktueller Level
** Alle Ebenen '''bis zur aktuellen Seite + deren Unterseiten''' falls vorhanden.
In letzten Fall könnte man auch Varianten bauen in denen eine Verschachtelte Liste erzeugt wird aber nur bestimmte Teile absolut Positioniert angezeigt werden und andere versteckt werden. Manchmal möchte man bestimmte Level aber auch an anderer Position zeigen (z.B. Sidebar)
In der Praxis hat man in der Regel
* Mindestens eine Hauptnavigation mit allen Seiten der 1. Ebene oder eine Hauptnavigation mit mehreren Ebenen für Dropdown Navigationen, mobile Navigation oder auch Sitemapartige Navigationen für den Footer (oft mit kleinen Beschreibungen).
* Eine Metanavigation mit Service Seiten wie Kontakt, Impressum etc. oft ist diese im Footer.

=== Unterschiede zwischen Verstecken, Veröffentlichen, Sperren ===
In Processwire sind diese Begriffe mit Userrechten verknüpft. Eine unveröffentlichte Seite kann also durchaus im Frontend aufgerufen werden (es sei denn man regelt das anders.) Vielmehr geht es darum das man User Rollen so gestalten kann, dass man z.B. einem User nur erlaubt unveröffentlichte Seiten zu editieren.

Denoch gibt es auch ein paar weitere Unterschiede.

Gesperrt -> Man kann die Seite nicht zum Editieren aufrufen. Über die Url kann Sie aufgerufen werden.

Unpublished -> Die Seite kann sobald sie gespeichert ist auch aufgerufen werden, WENN der User berechtigt ist. Nicht für Guest User (der normale Viewer)

TODO checken ob die Tabelle so für nicht angemeldete User stimmt.
{| class="wikitable"
|-
! !! Im Menü ($pages->find) !! Über URL erreichbar($pages->get) !! Ausgabe im Frontend !!
|-
| Unpublished / Unveröffentlicht || Nein || Nur User mit passenden Rechten. Gäste -> leere Seite ||
|-
| Hidden / Versteckt || Nein || Ja || Ja - leere Seite (keine Feldausgabe)
|-
| Locked / Gesperrt || Ja || Ja || Ja
|-
| Trash || Nein || Nein ||
|}
==== Seiten auf unveröffentlicht stellen ====
https://processwire.com/talk/topic/29-how-to-unpublish-a-page-without-deleting-it/

Was soll man tun wenn man eine Seite tatsächlich nicht mehr anzeigen will, sie aber noch nicht wegwerfen will?
Ryan schlägt folgendes vor:
* Mülleimer
* Remove Guest Role in Template
*

== Basics ==
=== Minimal Navigation Bar ===
Aus dem Standard Template
<syntaxhighlight lang="php">
<?php
$homepage = $pages->get("/");
$navigation = $homepage->and($homepage->children)->implode(" / ", "<a href='{url}'>{title}</a>");
?>
<p id="topnav">
<?= $navigation ?>
</p>
</syntaxhighlight>

=== Basic Navigation ===
<syntaxhighlight lang="php">
<?php
// get the homepage object
$homepage = $pages->get("/");
// get PageArray of homepage object and child page objects
$navItems = $homepage->and($homepage->children);
?>
Now you have a PageArray with the required items, you can iterate over them one at a time, and print the title of the page and the link to the page itself and wrap the whole thing in your list tag.

<ul class="nav">

<?php
// get the homepage object
$homePage = $pages->get("/");
// get PageArray of homepage object and child page objects
$navItems = $homePage->and($homePage->children);
// or if you don't want the home link
// $navItems = $homePage->children;
// iterate over the $navItems PageArray
foreach ($navItems as $navItem):
?>

<li class="nav-item">
<a class="nav-link" href="<?php echo $navItem->url; ?>"><?php echo $navItem->title; ?></a>
</li>

<?php endforeach; ?>

</ul>
</syntaxhighlight>

==== Basic mit active Class ====
<syntaxhighlight lang="php">
<ul class="nav">

<?php
// get the homepage object
$homePage = $pages->get("/");
// get PageArray of homepage object and child page objects
$navItems = $homePage->and($homePage->children);
// or if you don't want the home link
// $navItems = $homePage->children;
// iterate over the $navItems PageArray
foreach ($navItems as $navItem):

// if the id of the page currently being
// iterated equals the id of the current page
$activeClass = ($navItem->id == $page->id) ? " active" : "";
?>

<li class="nav-item">
<a class="nav-link<?php echo $activeClass; ?>" href="<?php echo $navItem->url; ?>"><?php echo $navItem->title; ?></a>
</li>

<?php endforeach; ?>

</ul>
</syntaxhighlight>

==== Child Menu ====
<syntaxhighlight lang="php">

<ul class="sub-menu">

<?php
// get children of the parent of the current page
$childPages = $page->parent->children;

// iterate over the $navItems PageArray
foreach ($childPages as $childPage):

// if the id of the page currently being
// iterated equals the id of the current page
$activeClass = ($navItem->id == $page->id) ? " active" : "";
?>

<li class="nav-item">
<a class="nav-link<?php echo $activeClass; ?>" href="<?php echo $childPage->url; ?>"><?php echo $childPage->title; ?></a>
</li>

<?php endforeach; ?>

</ul>
</syntaxhighlight>

=== Page Level ===
In which level in page tree we are?
$level = count($page->parents);

=== Parent, active parent ===
$isParent = $item->hasChildren;
$isActiveParent = $item->child('id='.$page->id)->id; // Seite ist in Rootline wenn sie ein aktives Kind hat

=== Link to Subpage und Platzhalter (Spacer) ===
Kann man gut für Superfish Menüs etc. benutzen. Bildet das Verhalten von Shortcuts und Spacern aus TYPO3 nach.

Anpassung der renderNavTree() Funktion von Ryan Cramer. Options Field Installieren und als globales Feld "navigation_type" mit den Optionen
<pre>
1=normal|Normal
2=doNotLink|Do not link
3=linkToFirstChild|Link to first childpage
</pre>
konfigurieren. Dann Funktion etwa so anpassen:
<pre>
...
// cycle through all the items
foreach($items as $item) {

// markup for the list item...
// if current item is the same as the page being viewed, add a "current" class to it
$out .= $item->id == wire('page')->id ? "<li class='current'>" : "<li>";

// markup for the link
$navigation_type = $item->navigation_type->id;
switch ( $navigation_type ) {
case 2: // do not link
$out .= "<span class='spacer'>$item->title</span>";
break;
case 3: // link to subpage
if( $item->hasChildren() ){
$out .= '<a href="'.$item->child->url.'">'.$item->title.'</a>';
}else{
$out .= "<span class='spacer'>$item->title</span>";
}
break;
default:
$out .= "<a href='$item->url'>$item->title</a>";
break;
}
...
</pre>

=== Redirect (301) ===
==== Redirect zu erster Unterseite ====
https://processwire.com/talk/topic/15-how-do-i-create-a-page-that-redirects-to-its-first-child/

Field ''redirects_to_first_child'' erstellen und im Template einfügen.
<syntaxhighlight lang="php">
<?php
if($page->numChildren && $page->redirects_to_first_child)
$session->redirect($page->child()->url);
?>
</syntaxhighlight>
Erzeugt 301 Weiterleitung

Anderer Ansatz wäre evtl. den Link bei der Menügenerierung direkt zu generieren. finde ich persönlich besser siehe ''Link to subpage und Platzhalter'' Beispiel. Allerdings sollte man dann vielleicht die Seite trotzdem per 301 Weiterleiten, falls die URL mal direkt aufgerufen wird oder bei Google gelistet ist.

==== Redirect zu anderer Seite in der Navigation ====
https://processwire.com/talk/topic/762-howto-menu-item-that-links-to-another-page/

1. Create a new field and call it 'redirect_url' or something like that, and use the 'URL' fieldtype.

2. Add that field to your template where you'd want to use it, or create a new template just for the purpose, like a template named 'redirect'.

3. Edit the page that you want to be a symlink and populate the 'redirect_url' field with the URL you want it to redirect to.

4. In your nav-generation code that links to the pages, do something like this:

<syntaxhighlight lang="php">
<?php
$url = $subpage->get("redirect_url|url"); // use redirect_url if there, otherwise use url
echo "<a href='$url'>{$subpage->title}</a>";
</syntaxhighlight>
5. You might also want to add this to your template that has the 'redirect_url' field: just in case there's anything linking to it directly. That way it'll send people to the right place either way:

<?php
if($page->redirect_url) $session->redirect($page->redirect_url);

=== Breadcrumb ===
<pre>

<div class='breadcrumbs'><?php
// breadcrumbs are the current page's parents
foreach($page->parents() as $item) {
echo "<span><a href='$item->url'>$item->title</a></span> ";
}
// optionally output the current page as the last item
echo "<span>$page->title</span> ";
?></div>
</pre>

=== One Level Navigation Bar ===
[[ProcessWire - One Level Navigation]]
=== Nächste Seite / Next Page Navigation ===
Beispiel 1
<syntaxhighlight lang="php">
if($page->next->id){
$next = '
<div class="next">
<i>Next:</i> 
<a class="ajax-link" name="'.$page->next->title.'" href="'. $page->next->url .'">
'. $page->next->title .'<span class="fa fa-arrow-right"><span>
</a>
</div>';
}
</syntaxhighlight>

Beispiel 2 (mit zurück zur Elternseite)
<syntaxhighlight lang="php">
$next = '';
if($page->next->id){
$next = '
<a href="'.$page->next->url.'">
<i class="fa fa-angle-right"></i>
</a>
';
}

$prev = '';
if($page->prev->id){
$prev = '
<a href="'.$page->prev->url.'" class="w-inline-block paginaton-but">
<i class="fa fa-angle-left"></i>
</a>';
}

$pagination = '
<div class="container pagination">
<div class="row">

<div class="col col-md-4">
<div class="align-center">
'.$prev.'
</div>
</div>

<div class="col col-md-4">
<div class="align-center">
<a href="'.$page->parent->url.'">
<i class="fa fa-th"></i>
</a>
</div>
</div>

<div class="col col-md-4">
<div class="align-right center">
'.$next.'
</div>
</div>
</div>

</div>
';

echo $pagination;
</syntaxhighlight>

=== Zurück zur Elternseite ===
<syntaxhighlight lang="php">
<div class="back"><a href="'.$page->parent()->url.'">zurück</a></div>
</syntaxhighlight>

=== Kindseiten mit $page->children ===
<?=$page->children?>
Output
5723,4958,5937

Beispiel
<syntaxhighlight lang="php">
<ul>
<?php
foreach($page->children as $child)
echo "<li><a href='{$child->url}'>{$child->title}</a></li>";
?> 
</ul>
</syntaxhighlight>
Ergebnis:
<pre>
<ul> 
<li><a href='/about/contact/'>Contact Us</a></li>
<li><a href='/about/press/'>Press Releases</a></li>
<li><a href='/about/staff/'>Our Staff</a></li> 
</ul>
</pre>
=== Children Tree ===
<syntaxhighlight lang="php">
function listChildrenTree($children, $current, $w) {

echo "<ul>";

foreach($children as $page) {

$class = '';
if($page === $current || $current->parents->slice(1)->has($page) ) {
$class = "class='on' style='font-weight:bold'";
}

$rootid = $w->pages->get("/")->id;

echo "<li><a href='{$page->url}' $class>";
if($page->id == $rootid) echo "<img src='" . $w->config->urls->templates . "styles/images/home.png' width='24' height='28' alt='' />";
echo "{$page->title}</a> ";

if($page->numChildren && $page->id != $rootid) listChildrenTree($page->children, $current, $w);

echo "</li>";
}
echo "</ul>";
}

$children = $pages->get("/")->children();
$children->prepend($pages->get("/"));

listChildrenTree($children, $page, $wire);
</syntaxhighlight>

== Bootstrap Navigation ==
<syntaxhighlight lang="php">
<?php namespace ProcessWire;
// Markup to use wicht navigation_type field (normal=1, no-link=2,subpage=3)
?>

<?php

// bundle up the first level pages and prepend the root home page
$homepage = $pages->get(1);
$pa = $homepage->children;
$pa = $pa->prepend($homepage);

// Set the ball rolling...
$myMenu = renderChildrenOf($pa);
$wrapper = '
<nav class="navbar navbar-default">
<div class="container-fluid">
<div class="navbar-header">
<button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#navbar-collapse-1" aria-expanded="false">
<span class="sr-only">Menü</span>
<span class="icon-bar"></span>
<span class="icon-bar"></span>
<span class="icon-bar"></span>
</button>
</div>
<div class="collapse navbar-collapse" id="navbar-collapse-1">
|
</div>
</div>
</div>';
$myMenu = wrap($myMenu,$wrapper);
echo $myMenu;

/*
Navigation for ProcessWire using the Bootstrap 2.2.2 markup
This menu was written by Soma based on work by NetCarver and a bit thrown in by Joss
Bootstrap 3 update by Damienov, with multi level dropdown support fix
*/
function renderChildrenOf($pa, $output = '', $level = 0)
{
$output = '';
$level++;

foreach ($pa as $child) {
$atoggle = '';
$class = '';

if ($child->numChildren && count($child->parents) == 1) {
$class .= 'dropdown';
$atoggle .= ' class="dropdown-toggle" data-toggle="dropdown"';
} else if ($child->numChildren && count($child->parents) > 1 ) {
$class .= 'dropdown-submenu';
$atoggle .= ' class="dropdown-toggle"';
} else if ($child->numChildren && $child->id != 1) {
$class .= 'dropdown-menu';
}

// Makes the current page and it's top level parent add an active class
$class .= ($child === wire("page") || $child === wire("page")->rootParent) ? " active" : '';
$class = strlen($class) ? " class='" . trim($class) . "'" : '';

if ($child->numChildren && count($child->parents) == 1) {
// Add Caret if have children
$output .= "<li$class><a href='$child->url'$atoggle>$child->title <b class='caret'></b></a>";
} else if ($child->numChildren && count($child->parents) > 1) {
$output .= "<li$class><a tabindex='-1' href='$child->url'$atoggle>$child->title</a>";
} else {
$output .= "<li$class><a href='$child->url'$atoggle>$child->title</a>";
}

// If this child is itself a parent and not the root page, then render it's children in their own menu too...
if ($child->numChildren && $child->id != 1) {
$output .= renderChildrenOf($child->children, $output, $level);
}
$output .= '</li>';
}
$outerclass = ($level == 1) ? "nav navbar-nav" : 'dropdown-menu';
return "<ul class='$outerclass'>$output</ul>";
}

?>
</syntaxhighlight>

== Modul: MarkupSimpleNavigation==
[[Processwire Modul - MarkupSimpleNavigation]]

== Weitere Menübeispiele ==
=== Flexible Funktion zum erzeugen von Tree oder Listen Navigationen ===
//Todo fix depth (siehe MenuShifter Modul)
* ul-Liste oder nur li
* Rendertiefe einstellbar
* Page Objekt von dem Kinder gerendert werden oder PageArray
* Filter (Selector) für Kindobjekte.
* Root voranstellen oder auch nicht (z.B. für Homepage)

<syntaxhighlight lang="php">
/**
* Rendert eine Navi. Kindseiten wenn eine Page übergeben wird.
* Alle Seiten inkl. Kinder wenn ein PageArray übergeben wird.
*
*/
function nav($items,$options = array()){
static $depth = 0;
$defaults = array(
'ul' => true, // wrap in <ul> or not
'class' => '', // class for ul
'depth' => 1, // render depth
'selector' => '', // filters child elements
'prependRoot' => false // if you provide a Page (i.e. home), prepend as menu item
);
$options = array_merge($defaults, $options);
$page = $items->wire('page'); // current page
$class = $depth ? "nav-sub" : rtrim("nav $options[class]");
$attr = rtrim("class='$class'");
$out = $options['ul'] ? "<ul $attr>" : "";
// if given a Page use children as the items and use Page as the header
// if given a page array use each Page as the items
if($items instanceof Page) {
//$header = $items;
if($options['prependRoot']) $out .= "<li class='root'> <a href='$items->url'>$items->title</a></li>";
$items = $items->children($options['selector']);
}
if(!$items->count) return '';

foreach($items as $n => $item) {
$isParent = $options['depth'] && $item->hasChildren && $depth < $options['depth'];
$classes = array();

// determine additional classes
if($item->id == $page->id) $classes[] = 'active';
if($isParent) $classes[] = 'parent';

// open the list item
$out .= count($classes) ? "<li class='" . implode(' ', $classes) . "'>" : "<li>";
$out .= "<a href='$item->url'>$item->title</a>";
// see if we are working with a nested list and go recursive if so
if($isParent) {
$depth++;
$children = $item->children($options['selector']);
$out .= nav($children, array(
'depth' => $options['depth'],
'selector' => $options['selector']
));
$depth--;
}

// close the list item
$out .= "</li>";
}
if($options['ul']) $out .= "</ul>";
return $out;
}
</syntaxhighlight>

=== Standard Tree Navigation ===
Für viele Zwecke ausreichend und leicht anpassbar, die klassische verschachtelte Liste.

=== Menüauswahl Hauptmenü / Metamenü / Footer-Navigation ===
Beispiel 1
Backend Feld menus anlegen Options:

1=Main Menu
2=Meta Menu

topnav.inc
<syntaxhighlight lang="php">
$pa = $homepage->and($homepage->children("menus.id=1"));//only if main menu is checked
$options = array('level' => '1', 'ulClass' => 'sf-menu', 'liClass' => '');
echo "<div>".renderNavTreeType($pa, $maxDepth = 1, $fieldNames = '', $options)."</div>";
</syntaxhighlight>

'''Beispiel 2 (älter)'''

Checkbox anlegen (footer_nav), und dann das Seitenarray etwa so modifizieren.
<pre>
$footer_nav = $pages->find("parent=1, footer_checkbox=1");
$main_nav = $pages->find("parent=1, footer_checkbox!=1");
</pre>

=== Zweispaltige Navigation aus Kindseiten ===
Verbesserungsvorschlag: Anstatt if lieber zwei for Schleifen -> bessere Performance
<syntaxhighlight lang="php">
// Childrens
$n = count($page->children);
$m = ceil($n/2);
$c = 0;

// NAVIGATION & SLIDER Items
$listItem = '';
$navList = '';
$col1 = '<ul class="nav-list col1">';
$col2 = '<ul class="nav-list col2">';
foreach ($page->children as $item) {
if($item->id == $page->rootParent->id) {
$listItem = '<li class="current">';
} else {
$listItem = '<li>';
}
$listItem .= '<a class="ajax-link" href="'.$item->url.'">'.$item->title.'</a></li>';
($c < $m) ? $col1 .= $listItem : $col2 .= $listItem;
$c++;
}
$col1 .= '</ul>';
$col1 .= '</ul>';
$navList = $col1.$col2;
</syntaxhighlight>

Mehrspaltige Navigationen lassen sich auch mit der slice Funktion erstellen:

<syntaxhighlight lang="php">
$categories = $pages->get('/about/sites/categories/')->children();
foreach($categories->slices(3) as $items) {
echo "<div class='uk-width-1-3'><ul>";
echo $items->each("<li><a href='{url}'>{title}</a>");
echo "</ul></div>";
}
</syntaxhighlight>

=== Pushy Menu ===
<syntaxhighlight lang="php">
/**
* Given a group of pages, render a <ul> navigation tree
*
* This is here to demonstrate an example of a more intermediate level
* shared function and usage is completely optional. This is very similar to
* the renderNav() function above except that it can output more than one
* level of navigation (recursively) and can include other fields in the output.
* Assumes there is a field navigation_type to decide how a list item is
* rendered
*
* @param array|PageArray $items
* @param int $maxDepth How many levels of navigation below current should it go?
* @param string $fieldNames Any extra field names to display (separate multiple fields with a space)
* @param array $options extra options for classes configuration etc.
* @return string
*
*/
function renderPushyMenu($items, $maxDepth = 0, $fieldNames = '', $options = array('level' => 0, 'ulClass' => '', 'liClass' => '', 'aClass' => '') ) {

// if we were given a single Page rather than a group of them, we'll pretend they
// gave us a group of them (a group/array of 1)
if($items instanceof Page) $items = array($items);
$out = '';
$c = 0;
$liClasses = array();
$ulClasses = array();
$level = 0;
$liClass = '';
$ulClass = '';

if(!empty($options['level'])) $level = $options['level'];
if(!empty($options['ulClass'])) {
$ulClasses[] = $options['ulClass'];
$ulClass = $options['ulClass'];
}

if(!empty($options['liClass'])) {
$liClasses[] = $options['liClass'];
$liClass = $options['liClass'];
}

// cycle through all the items
foreach($items as $item) {
//$level = count($page->parents);
// LI ITEM
$classes = $liClasses;
//if($item->id == wire('page')->id) $classes[] = 'cur';
if($item->hasChildren) {
// BUTTON instead of Link
$out .= '<li class="pushy-submenu"><button>'.$item->title.'</button>';
}else{
$classes[] = 'level-'.$level;
$out .= '<li class="'.implode($classes,' ').'">';
unset($classes);

// A ITEM
$navigation_type = $item->navigation_type->id;
$classes = $liClasses;
switch ( $navigation_type ) {
case 2: // do not link
$out .= '<span class="spacer">'.$item->title.'</span>';
break;
case 3: // link to subpage
if( $item->hasChildren() ){
$out .= '<a href="'.$item->child->url.'" class="ajax-link">'.$item->title.'</a>';
}else{
$out .= "<span class='spacer'>$item->title</span>";
}
break;
default:
$out .= '<a href="'.$item->url.'" class="ajax-link">'.$item->title.'</a>';
break;
}
unset($classes);
}
// if there are extra field names specified, render markup for each one in a <div>
// having a class name the same as the field name
if($fieldNames) foreach(explode(' ', $fieldNames) as $fieldName) {
$value = $item->get($fieldName);
if($value) $out .= " <div class='$fieldName'>$value</div>";
}

// if the item has children and we're allowed to output tree navigation (maxDepth)
// then call this same function again for the item's children
if($item->hasChildren() && $maxDepth) {
//if($class == 'nav') $class = 'nav nav-tree';
$nextLevelOptions = array('level' => $level+1, 'ulClass' => '', 'liClass' => $liClass);
$out .= renderNavTreeType($item->children, $maxDepth-1, $fieldNames, $nextLevelOptions);
}

// close the list item
$out .= "</li>\n";
}

// if output was generated above, wrap it in a <ul>

if($out) $out = "\n".'<ul class="'.implode($ulClasses,' ').'">'."\n".$out.'</ul>'."\n";

// return the markup we generated above
return $out;
}

</syntaxhighlight>

== Do not link / link to subpage ==
=== MarkupSimpleNavigation XTemplate + Redirect Beispiel ===

https://github.com/s...default-options

'''Menü Platzhalter'''
<syntaxhighlight lang="php">
"xtemplate" => "folder|placeholder", // specify one or more templates
"xitem_tpl" => "<span>{title}</span>", // default markup for page with this template
"xitem_current_tpl" => "<span>{title}</span>"
echo $nav->render(array(
'max_levels'=>2,
'selector'=>"limit=10",
'xtemplates' => 'placeholder|folder'
));
</syntaxhighlight>

'''Redirect Template'''

You could also have a template "redirect" with only a title and a page field (single page) to select any page you want to go.

Then in the code you should be able to write
<syntaxhighlight lang="php">
array('item_tpl' => '<a href="{redirect_page|url}">{title}</a>')
</syntaxhighlight>
So it would take the url of the referenced page in the page field if found, or if not it takes the url of the page itself. Assuming the page field is named "redirect_page".

=== In der Navi ===
Zusätzliches Feld (Options) im Backend mit Namen navigation_type

Beispiel
<syntaxhighlight lang="php">
/**
* Given a group of pages, render a <ul> navigation tree
* If there is a field navigation_type the vals have following meaning
* 1 = Normal
* 2 = Do not link
* 3 = Link to subpage
*
* @param array|PageArray $items
* @param int $maxDepth How many levels of navigation below current should it go?
* @param string $fieldNames Any extra field names to display (separate multiple fields with a space)
* @param string $class CSS class name for containing <ul>
* @return string
*
*/
function renderNavTreeType($items, $maxDepth = 0, $fieldNames = '', $options = array('level' => 0, 'ulClass' => 'nav', 'liClass' => '', 'aClass' => '') ) {

// if we were given a single Page rather than a group of them, we'll pretend they
// gave us a group of them (a group/array of 1)
if($items instanceof Page) $items = array($items);

// $out is where we store the markup we are creating in this function
$out = '';
$c = 0;
$liClasses = array();
$ulClasses = array();
$level = 0;
$liClass = '';
$ulClass = '';

if(!empty($options['level'])) $level = $options['level'];
if(!empty($options['ulClass'])) {
$ulClasses[] = $options['ulClass'];
$ulClass = $options['ulClass'];
}

if(!empty($options['liClass'])) {
$liClasses[] = $options['liClass'];
$liClass = $options['liClass'];
}

// cycle through all the items
foreach($items as $item) {
//$level = count($page->parents);
// LI ITEM
$classes = $liClasses;
if($item->id == wire('page')->id) $classes[] = 'cur';
if($item->hasChildren) $classes[] = 'has_children';
$classes[] = 'level-'.$level;
$out .= '<li class="'.implode($classes,' ').'">';
unset($classes);

// markup for the link
$navigation_type = $item->navigation_type->id;
$classes = $liClasses;
switch ( $navigation_type ) {
case 2: // do not link
$out .= '<span class="spacer">'.$item->title.'</span>';
break;
case 3: // link to subpage
if( $item->hasChildren() ){
$out .= '<a href="'.$item->child->url.'" class="ajax-link">'.$item->title.'</a>';
}else{
$out .= "<span class='spacer'>$item->title</span>";
}
break;
default:
$out .= '<a href="'.$item->url.'" class="ajax-link">'.$item->title.'</a>';
break;
}
unset($classes);
// if there are extra field names specified, render markup for each one in a <div>
// having a class name the same as the field name
if($fieldNames) foreach(explode(' ', $fieldNames) as $fieldName) {
$value = $item->get($fieldName);
if($value) $out .= " <div class='$fieldName'>$value</div>";
}

// if the item has children and we're allowed to output tree navigation (maxDepth)
// then call this same function again for the item's children
if($item->hasChildren() && $maxDepth) {
//if($class == 'nav') $class = 'nav nav-tree';
$nextLevelOptions = array('level' => $level+1, 'ulClass' => '', 'liClass' => $liClass);
$out .= renderNavTreeType($item->children, $maxDepth-1, $fieldNames, $nextLevelOptions);
}

// close the list item
$out .= "</li>\n";
}

// if output was generated above, wrap it in a <ul>

if($out) $out = "\n".'<ul class="'.implode($ulClasses,' ').'">'."\n".$out.'</ul>'."\n";

// return the markup we generated above
return $out;
}
</syntaxhighlight>

=== Redirect über das Template ===
Sinnvoll wenn die URL direkt aufgerufen wird:

$session->redirect($page->redirect_page->url);
or how about "redirect-to-firstchild".

$session->redirect($page->children->first()->url);

== Beispiele für Funktionen (z.B. in _func.php)==
=== Externe Links finden ===
<syntaxhighlight lang="php">
public function isExternalLink($url) {
foreach($this->config->httpHosts as $hostname) {
// If the target host is one of our own hostnames,
// this link is not external.
if(preg_match("~^https?://{$hostname}~i", $url)) return false;
}

// Otherwise, all http(s) links are definitely external
// and get redirected.
if(preg_match('~^https?://~i', $url)) return true;

// No match, then we have a relative url (internal) or some other
// scheme (e.g. mailto) that we don't redirect.
return false;
}
</syntaxhighlight>
'''Beispiele für Funktionen die Navigationen erzeugen. '''
=== One Level ===
==== Original ProcessWire Demo Beispiel ====

=== Nested List ausgehend von einer Seite (meistens Homepage) ===
<syntaxhighlight lang="php">
<?php namespace ProcessWire;

/**
* Given a group of pages, render a ONE LEVEL NAVBAR
*
* @param array|PageArray $items
* @return string
*
*/
function renderNavMain($pa,$pageId){
if($pa instanceof Page) $pa = array($pa);
$out = '<nav class="menu menu--ferdinand"><ul class="nav navbar-nav menu__list">';
foreach($pa as $item) {
if($item->id == $pageId) {
$out .= "<li class=\"menu__item menu__item--current cur\">";
} else {
$out .= "<li class=\"menu__item\">";
}
// if template isotope-parent add first isotope-child name as hash
if($item->template->name == 'isotope-parent'){
$out .= '<a class="menu__link" href="'.$item->url.'#'.$item->child->name.'">'.$item->title.'</a></li>';
}else $out .= '<a class="menu__link" href="'.$item->url.'">'.$item->title.'</a></li>';
}
$out .= "</ul></nav>";
return $out;
}

/**
* Given a group of pages render a standard ISOTOP MARKUP
*
* @param array|PageArray $items
* @return string
*
*/
function renderNavIsotope($pa){
if($pa instanceof Page) $pa = array($pa);
$out = '<ul class="submenu">';
foreach($pa as $item){
$out .= '<li><a href="#'.$item->name.'" class="isotope-link">'.$item->title.'</a></li>';
}
$out .= "</ul>";
return $out;
}

/**
* Given a group of pages, render a simple <ul> navigation
*
* This is here to demonstrate an example of a simple shared function.
* Usage is completely optional.
*
* @param PageArray $items
* @return string
*
*/
function renderNav(PageArray $items) {

// $out is where we store the markup we are creating in this function
$out = '';

// cycle through all the items
foreach($items as $item) {

// render markup for each navigation item as an <li>
if($item->id == wire('page')->id) {
// if current item is the same as the page being viewed, add a "current" class to it
$out .= "<li class='current'>";
} else {
// otherwise just a regular list item
$out .= "<li>";
}

// markup for the link
$out .= "<a href='$item->url'>$item->title</a> ";

// if the item has summary text, include that too
if($item->summary) $out .= "<div class='summary'>$item->summary</div>";

// close the list item
$out .= "</li>";
}

// if output was generated above, wrap it in a <ul>
if($out) $out = "<ul class='nav'>$out</ul>\n";

// return the markup we generated above
return $out;
}

/**
* Given a group of pages, render a <ul> navigation tree
*
* This is here to demonstrate an example of a more intermediate level
* shared function and usage is completely optional. This is very similar to
* the renderNav() function above except that it can output more than one
* level of navigation (recursively) and can include other fields in the output.
*
* @param array|PageArray $items
* @param int $maxDepth How many levels of navigation below current should it go?
* @param string $fieldNames Any extra field names to display (separate multiple fields with a space)
* @param string $class CSS class name for containing <ul>
* @return string
*
*/
function renderNavTree($items, $maxDepth = 0, $fieldNames = '', $class = 'nav') {

// if we were given a single Page rather than a group of them, we'll pretend they
// gave us a group of them (a group/array of 1)
if($items instanceof Page) $items = array($items);

// $out is where we store the markup we are creating in this function
$out = '';

// cycle through all the items
foreach($items as $item) {

// markup for the list item...
// if current item is the same as the page being viewed, add a "current" class to it
$out .= $item->id == wire('page')->id ? "<li class='current'>" : "<li>";

// markup for the link
$out .= "<a href='$item->url'>$item->title</a>";

// if there are extra field names specified, render markup for each one in a <div>
// having a class name the same as the field name
if($fieldNames) foreach(explode(' ', $fieldNames) as $fieldName) {
$value = $item->get($fieldName);
if($value) $out .= " <div class='$fieldName'>$value</div>";
}

// if the item has children and we're allowed to output tree navigation (maxDepth)
// then call this same function again for the item's children
if($item->hasChildren() && $maxDepth) {
if($class == 'nav') $class = 'nav nav-tree';
$out .= renderNavTree($item->children, $maxDepth-1, $fieldNames, $class);
}

// close the list item
$out .= "</li>";
}

// if output was generated above, wrap it in a <ul>
if($out) $out = "<ul class='$class'>$out</ul>\n";

// return the markup we generated above
return $out;
}

</syntaxhighlight>

== Komplette Beispiele ==
[[ProcessWire - Navigation Beispiele]]

ProcessWire - TinyMCE Editor

2025-03-03T17:09:31Z

109.193.152.88:

Der TinyMCE Editor ist der Nachfolger des CKE Editor. Er läßt sich deutlich leichter modifizieren.

Styles lassen sich in den Moduleinstellungen anpassen:

Beispiel
<pre>
#Extras h5.accordion { } /* Accordion item heading */
#Extras h6 { } /* Tab item heading */
#Extras hr.stop { } /* Stop tabs or accordions */
#Blocks uk-text-lead {font-size: 1.5em } /* Lead text */
#Blocks .uk-text-meta { font-size: 14px; color: #999 } /* Meta text */
#Blocks .uk-text-small { font-size: 14px; } /* Small text */ #Uikit .uk-text-muted { color: #999; } /* Muted text */
#Inline span.red-text { color: red; } /* Red Text */
#Blocks p.outline { padding: 20px; border: 1px dotted #ccc; } /* Outline paragraph
</pre>

Wobei #Blocks für den Menübereich steht und der Kommentar für das /* Label */

ProcessWire - TinyMCE Editor

2025-03-03T16:53:50Z

109.193.152.88: Die Seite wurde neu angelegt: „Der TinyMCE Editor ist der Nachfolger des CKE Editor. Er läßt sich deutlich leichter modifizieren.“

Der TinyMCE Editor ist der Nachfolger des CKE Editor. Er läßt sich deutlich leichter modifizieren.

ProcessWire - Editor

2025-03-03T16:52:40Z

109.193.152.88:

Dieser Artikel bezieht sich auf den alten CKEditor. In neueren Versionen wird der TinyMCE Editor verwendet.

[[ProcessWire - TinyMCE Editor]]

'''HINWEIS: Bei Änderungen an den Styles unbedingt Modul-Cache löschen (Module > Aktualisieren)'''
== Links ==

https://processwire.com/talk/topic/3023-module-ckeditor/
https://processwire.com/talk/topic/14601-solved-ckeditor-custom-stylesclasses/
https://processwire.com/talk/topic/19465-ckeditor-styles-dropdown-tips/

[[CKEditor - Snippets]]

CHECKEN:
https://processwire.com/talk/topic/23437-ckeditor-global-custom-config-frontend-styles-in-the-editor/
Automatische Konfiguration für alle CKEditor Felder

== Tipp - effektives Anpassen ==
Mit der Erweiterung AdminOnSteroids kann man die Anpassungen vereinfachen, da man nicht in jedes Feld muss. Todo - kleineres Modul als Alternative finden.

== Der CKEditor in ProcessWire ==
Ist der Standard Editor in PW. Es gibt auch Module mit denen man Ihn ersetzen kann. Im Prinzip aber ein mächtiges Werkzeug.

Hinweis: In neueren Versionen von PW (mindestens ab V3) Sind einige der Angaben unten überholt. Zum Teil funktionieren Sie aber ncoh. Als Referenz bleiben Die Tutorials auf dieser Seite unten erhalten

== Konfiguration ==

=== Buttons ===
Im Backend anpassen

=== Format Stile ===
In der Feldkonfiguration unter
Input > Format Tags

=== Eigene Styles ===
Im Styles Dropdown kann man eigene Stile inklusive Klassen definieren.

==== Styles Dropdown Feld im Editor aktivieren ====
'''1. Styles Dropdown aktivieren'''

Feldkonfiguration unter CK Editor Toolbar
Styles
hinzufügen (am besten hinter Format)

==== Eigene Stildefinitionen in der Styles Datei ====
''' 2.Styles Datei hinzufügen '''
Datei unter Eigenes JS Styles Set angeben...
customstyles:/site/templates/modules/InputfieldCKEditor/mystyles.js
und Datei anlegen. Die sieht z.B. so aus:

<syntaxhighlight lang="javascript">
CKEDITOR.stylesSet.add( 'customstyles', [
{ name: 'Home Icon', element: 'i', attributes: {'class': 'fa fa-home fa-2x'}},
{ name: 'Panel Title', element: 'h4', attributes: {'class': 'panel-title'} },
]);
CKEDITOR.dtd.$removeEmpty['i'] = false; // leere i Tags erlauben (für font awesome)
</syntaxhighlight>
Hinweis: '''Nicht mystyles:'''/site/... Verwenden das führt zu Problemen im Backend. Mal sind die Stile da mal nicht. Also z.B. '''customstyles in der Pfadangabe UND in der Datei verwenden.'''

Ausführliches Beispiel:

<syntaxhighlight lang="javascript">
/* v1.2 */
CKEDITOR.stylesSet.add( 'customstyles', [

/* Objektstile */
{ name: 'Bild: Rund', element: 'img', attributes: { 'class': 'uk-border-circle' } },

/* Blockstyles */
{ name: 'Lead', element: 'div', attributes: { 'class': 'uk-text-lead' } },
{ name: 'Zweispalter', element: 'div', attributes: { 'class': 'uk-column-1-2@s' } },
{ name: 'Dreipalter', element: 'div', attributes: { 'class': 'uk-column-1-2@s uk-column-1-3@m' } },
{ name: 'Vierspalter', element: 'div', attributes: { 'class': 'uk-column-1-2@s uk-column-1-4@m' } },
{ name: 'H2 Extra Bold', element: 'h2', attributes: { 'class': 'extra-bold' } },
{ name: 'H3 mit Trennlinie', element: 'h3', attributes: { 'class': 'uk-heading-divider' } },
{ name: 'H3 mit Linie dahinter', element: 'h3', attributes: { 'class': 'line-behind' } },
{ name: 'H3 kein Abstand unten', element: 'h3', attributes: { 'class': 'uk-margin-remove-adjacent uk-margin-remove-bottom' } },
{ name: 'Kein Randabstand', element: 'div', attributes: { 'class': 'no-padding no-margin' } },
/*{ name: 'Heading Line', element: 'h3', attributes: { 'class': 'uk-heading-line' } },
{ name: 'Heading Bullet', element: 'h3', attributes: { 'class': 'uk-heading-bullet' } },*/
{ name: 'Dropcap', element: 'div', attributes: { 'class': 'uk-dropcap' } },
{ name: 'Liste (UIkit)', element: 'ul', attributes: { 'class': 'uk-list uk-list-bullet'}},
{ name: 'Liste gestreift (UIkit)', element: 'ul', attributes: { 'class': 'uk-list uk-list-striped'}},

/* Inline Styles */
{ name: 'Link-Button (UIkit)', element: 'a', attributes: { 'class': 'uk-button uk-button-text' } },
{ name: 'Primary Button (UIkit)', element: 'a', attributes: { 'class': 'uk-button uk-button-primary' } },
{ name: 'Secondary Button (UIkit)', element: 'a', attributes: { 'class': 'uk-button uk-button-secondary' } },
{ name: 'Klein (UIkit)', element: 'span', attributes: { 'class': 'uk-text-small' } },
{ name: 'Groß (UIkit)', element: 'span', attributes: { 'class': 'uk-text-large' } },
{ name: 'Kleinbuchstaben (UIkit)', element: 'span', attributes: { 'class': 'uk-text-lowercase' } },
{ name: 'Großbuchstaben (UIkit)', element: 'span', attributes: { 'class': 'uk-text-uppercase' } },
{ name: 'Kapitälchen (UIkit)', element: 'span', attributes: { 'class': 'uk-text-capitalize' } },
{ name: 'Farbe: Hell (UIkit)', element: 'span', attributes: { 'class': 'uk-light' } },
{ name: 'Farbe: Dunkel (UIkit)', element: 'span', attributes: { 'class': 'uk-dark' } },
{ name: 'Farbe: Muted (UIkit)', element: 'span', attributes: { 'class': 'uk-text-muted' } },
{ name: 'Farbe: Primär (UIkit)', element: 'span', attributes: { 'class': 'uk-text-primary' } },
{ name: 'Farbe: Erfolg (UIkit)', element: 'span', attributes: { 'class': 'uk-text-success' } },
{ name: 'Farbe: Warnung (UIkit)', element: 'span', attributes: { 'class': 'uk-text-warning' } },
{ name: 'Farbe: Gefahr (UIkit)', element: 'span', attributes: { 'class': 'uk-text-danger' } },
{ name: 'Klein', element: 'small' },
{ name: 'Gelöscht', element: 'del' },
{ name: 'Eingefügt', element: 'ins' },
{ name: 'Zitat', element: 'cite' }
]);

// Auch Code ist möglich:
// add inline font-size from 12px to 48px
for(var i = 12; i <= 48; i++) {
myStyles.push({name: 'text ' + i, element: 'span', attributes: {'style': 'font-size: ' + i + 'px;'}});
}
</syntaxhighlight>

=== Extra Allowed Content ===
Manche Tags werden ausgefiltert. Eigentlich sollte man im Backend CKEditor Extra Allowed Content Regeln anlegen können. Aber Vorsicht: Der '''HTML Purifier filtert''' zusätzlich Tags aus. (z.B. Button Tags) Also im Zweifel mal diesen ausschalten.
site->modules->InputfieldCKEditor->mystyle.js
<syntaxhighlight lang="javascript">
config.allowedContent = true;
config.extraAllowedContent = 'p(*)[*]{*};div(*)[*]{*};li(*)[*]{*};ul(*)[*]{*}';
CKEDITOR.dtd.$removeEmpty.i = 0;
</syntaxhighlight>
==== i Tag erlauben (Möglichkeit 2)====
Siehe oben und erlaube
// ALLOW <i></i>
config.protectedSource.push(/<i[^>]*><\/i>/g);

==== ExtraAllowedContent Beispiel: Buttons erlauben ====
Dieses Beispiel ist nur mittelmäßig nützlich. Oft ist es besser einen Style für ein a Tag zu basteln. Da im Editor Buttons ohnehin normalerweise irgendwo hin linken.
<pre>
config.allowedContent = true;
config.extraAllowedContent = 'button(*)[*]{*};div(*)[*]{*};li(*)[*]{*};ul(*)[*]{*}';
CKEDITOR.dtd.$removeEmpty.i = 0;
</pre>

== Aussehen des Editors anpassen ==
Außer den Styles die man dem User anbietet, kann man auch den Editor selbst anpassen und die Usability verbessern:

=== Styles Dropdown verbessern ===
https://processwire.com/talk/topic/19465-ckeditor-styles-dropdown-tips/

==== 1. Styles im Dropdown verbessern ====

Standardmäßig nutzt das Style Dropdown die Styles für den Content. Das ist z.B. bei großen Schriftn nicht immer sinnvoll. Das läßt sich aber in den Customstyles überschreiben.

templates/modules/CKEditor/contents.css
<syntaxhighlight lang="css">
/* Styles to load in CKEditor for better usabilty */

.cke_panel_grouptitle {
position: sticky;
top: 0;
z-index: 99;
}

html.cke_panel_container {
scroll-behavior: auto;
}

html.cke_panel_container .cke_panel_listItem > a * {
margin: 0 !important;
font-size: 0.97rem !important;
}

[data-list-style] li {
margin-bottom: 0.5rem;
}

[data-list-style="decimal-leading-zero"] {
list-style-type: decimal-leading-zero;
}

[data-list-style="upper-roman"] {
list-style-type: upper-roman;
}

[data-list-style="checkmark"] {
color: inherit;
list-style: none;
padding-left: 1.25rem;
}

[data-list-style="checkmark"] li {
position: relative;
}

[data-list-style="checkmark"] li::before {
content: '\2714';
position: absolute;
left: -1.1rem;
}
</syntaxhighlight>

== CKEditor allgemeines Wissen ==
Ein paar Infos zu CKEditor ohne PW. Viele Dinge sind ähnlich.
=== Konfiguration ===
==== Toolbar ====
http://docs.cksource.com/CKEditor_3.x/Developers_Guide/Toolbar

=== Plugins ===
Werden normalerweise mit einem Builder implementiert. Das geht bei PW nicht. Aber es gelten zum Teil die Regeln für Manuelle Installation. Manche Schritte z.B. aktivieren der Plugins macht man in PW aber wahlweise über die Feldkonfiguration.

Beispiel Widget Plugin:

If you want to add the plugin manually, you will need to:
* Extract the downloaded plugin .zip into the plugins folder of your CKEditor installation. Example:
http://example.com/ckeditor/plugins/widget
* Enable the plugin by using the extraPlugins configuration setting. Example:
config.extraPlugins = 'widget';
* Download and configure all its '''dependencies''', too.
In PW

== Snippets ==
Siehe auch
https://processwire.com/talk/topic/17862-share-your-ckeditor-settings/
=== Tabellenmodul anpassen ===
<syntaxhighlight lang="javascript">
Here is another snippet that I use to get rid of unwanted table properties:

// Remove unwanted attributes from tables
CKEDITOR.on('dialogDefinition', function(ev) {
var dialogName = ev.data.name;
var dialogDefinition = ev.data.definition;

if (dialogName == 'table') {
var info = dialogDefinition.getContents('info');
info.remove('txtWidth');
info.remove('txtHeight');
info.remove('txtBorder');
info.remove('txtCellPad');
info.remove('txtSummary');
info.remove('txtCellSpace');
info.remove('cmbAlign');
var advanced = dialogDefinition.getContents('advanced');
advanced.remove('advStyles');
advanced.remove('advId'); //Id attribute
advanced.remove('advLangDir'); // writing direction
advanced.get('advCSSClasses')['default'] = 'uk-table'; //set default class for table
}
</syntaxhighlight>

Put this code inside your custom config.js

=== Praktisches Beispiel 1===

Im Tab Eingabe des Editor Felds kann man verschiedene Dinge Einstellen. Die meisten Felder sind auch recht gut erklärt:

'''Editor Toolbar einstellen'''

Interessant ist hier der '''Eintrag Styles'''. Das Formatdialogfeld formatiert einzelne Blockstile wie h1 oder p. Im Styles Dropdown kann man auch Umgebende Blockelemente wie z.B. Divs mit speziellen Klassen nutzen.

Guter Standard mit Tabellen und Styles Dropdown
<pre>
Format, Styles, -, Bold, Italic,Superscript, -,JustifyLeft,JustifyCenter,JustifyRight,-, RemoveFormat
NumberedList, BulletedList, -, Blockquote
PWLink, Unlink, Anchor

PWImage, Table, HorizontalRule, SpecialChar
PasteText, PasteFromWord,-,Undo,Redo
Scayt, -, Sourcedialog
</pre>
'''Tags formatieren'''

Hier kann man festlegen welche '''Tags im Format Dropdown''' ausgewählt werden können. Hier ein Beispiel bei dem wir h1 weglassen. H1 wird oft über das Template selbst ausgegeben und sollte nur einmal pro Seite auftauchen.
<pre>
p;h2;h3;h4;h5;h6;pre;address;div
</pre>

''' Styles festlegen '''

Um die oben erwähnten Styles anzupassen wir eine kleine JavaScript Datei. Wo diese liegt legen wir im Abschnitt '''Eigenes Editor-JS-Style-Set''' fest. Wir nutzen NICHT den bereits vorgeschlagenen Pfad, sonst wäre bei einem Update alles weg. Besser in /site/templates/modules speichern:
customstyles:/site/templates/modules/InputfieldCKEditor/mystyles.js

UIkit Beispiel
<syntaxhighlight lang="javascript">
/* v1.2 */
CKEDITOR.stylesSet.add( 'customstyles', [

/* Objektstile */
{ name: 'Bild: Rund', element: 'img', attributes: { 'class': 'uk-border-circle' } },

/* Blockstyles */
{ name: 'Lead', element: 'div', attributes: { 'class': 'uk-text-lead' } },
{ name: 'Zweispalter', element: 'div', attributes: { 'class': 'uk-column-1-2@s' } },
{ name: 'Dreipalter', element: 'div', attributes: { 'class': 'uk-column-1-2@s uk-column-1-3@m' } },
{ name: 'Vierspalter', element: 'div', attributes: { 'class': 'uk-column-1-2@s uk-column-1-4@m' } },
{ name: 'H2 Extra Bold', element: 'h2', attributes: { 'class': 'extra-bold' } },
{ name: 'H3 mit Trennlinie', element: 'h3', attributes: { 'class': 'uk-heading-divider' } },
{ name: 'H3 mit Linie dahinter', element: 'h3', attributes: { 'class': 'line-behind' } },
{ name: 'H3 kein Abstand unten', element: 'h3', attributes: { 'class': 'uk-margin-remove-adjacent uk-margin-remove-bottom' } },
{ name: 'Kein Randabstand', element: 'div', attributes: { 'class': 'no-padding no-margin' } },
/*{ name: 'Heading Line', element: 'h3', attributes: { 'class': 'uk-heading-line' } },
{ name: 'Heading Bullet', element: 'h3', attributes: { 'class': 'uk-heading-bullet' } },*/
{ name: 'Dropcap', element: 'div', attributes: { 'class': 'uk-dropcap' } },
{ name: 'Liste (UIkit)', element: 'ul', attributes: { 'class': 'uk-list uk-list-bullet'}},
{ name: 'Liste gestreift (UIkit)', element: 'ul', attributes: { 'class': 'uk-list uk-list-striped'}},

/* Inline Styles */
{ name: 'Link-Button (UIkit)', element: 'a', attributes: { 'class': 'uk-button uk-button-text' } },
{ name: 'Primary Button (UIkit)', element: 'a', attributes: { 'class': 'uk-button uk-button-primary' } },
{ name: 'Secondary Button (UIkit)', element: 'a', attributes: { 'class': 'uk-button uk-button-secondary' } },
{ name: 'Klein (UIkit)', element: 'span', attributes: { 'class': 'uk-text-small' } },
{ name: 'Groß (UIkit)', element: 'span', attributes: { 'class': 'uk-text-large' } },
{ name: 'Kleinbuchstaben (UIkit)', element: 'span', attributes: { 'class': 'uk-text-lowercase' } },
{ name: 'Großbuchstaben (UIkit)', element: 'span', attributes: { 'class': 'uk-text-uppercase' } },
{ name: 'Kapitälchen (UIkit)', element: 'span', attributes: { 'class': 'uk-text-capitalize' } },
{ name: 'Farbe: Hell (UIkit)', element: 'span', attributes: { 'class': 'uk-light' } },
{ name: 'Farbe: Dunkel (UIkit)', element: 'span', attributes: { 'class': 'uk-dark' } },
{ name: 'Farbe: Muted (UIkit)', element: 'span', attributes: { 'class': 'uk-text-muted' } },
{ name: 'Farbe: Primär (UIkit)', element: 'span', attributes: { 'class': 'uk-text-primary' } },
{ name: 'Farbe: Erfolg (UIkit)', element: 'span', attributes: { 'class': 'uk-text-success' } },
{ name: 'Farbe: Warnung (UIkit)', element: 'span', attributes: { 'class': 'uk-text-warning' } },
{ name: 'Farbe: Gefahr (UIkit)', element: 'span', attributes: { 'class': 'uk-text-danger' } },
{ name: 'Klein', element: 'small' },
{ name: 'Gelöscht', element: 'del' },
{ name: 'Eingefügt', element: 'ins' },
{ name: 'Zitat', element: 'cite' }
]);
</syntaxhighlight>
Hinweis: Span Elemente sind oft p Elementen vorzuziehen, da sie Inline angewendet werden können. So ist es möglich einen Muted Text innerhalb eines Absatzes einzusetzen.

Einfaches Beispiel
<syntaxhighlight lang="javascript">
CKEDITOR.stylesSet.add( 'customstyles', [
{ name: 'Mein Spezialabsatz', element: 'p', attributes: { 'class': 'myParagraphStyle' } },
{ name: 'Klein', element: 'small' },
{ name: 'Gelöscht', element: 'del' },
{ name: 'Eingefügt', element: 'ins' },
{ name: 'Zitat', element: 'cite' }
]);
</syntaxhighlight>

''' Stile im Editor einbinden '''

=== DIV-Stile ===
Mit dem CreateDiv Plugin kann man Stile auch auf Blockelemente statt nur auf Inline Elemente anwenden. Praktisch z.B. für Kästchen etc.
<pre>
Format, Styles, CreateDiv, -, Bold, Italic,Superscript, -,JustifyLeft,JustifyCenter,JustifyRight,-, RemoveFormat
NumberedList, BulletedList, -, Blockquote, PWLink, Unlink, Anchor

PWImage, Table, HorizontalRule, SpecialChar
PasteText, PasteFromWord, -, Undo, Redo, -, Scayt, -, Sourcedialog
</pre>

== Weiter Forum Beispiele ==
https://processwire.com/talk/topic/9606-how-to-configure-ckeditortextarea-field-to-enable-color-toolbar/

== Konfiguration CKEditor in PW (alt)==

/sites
ausgelagert und somit auch Updatefähig. Abschauen kann man im original Modul in
wire/site/modules/InputfieldCKEditor/
Dort gibe es diverse Dateien. Allerdings ist nicht alles möglich, was in der CKEditor Doku steht. In PW können scheinbar manche Einstellungen nicht über die Dateien geregelt werden.

=== Wo stellt man was ein ? ===
'''Hinweis:''' Nicht alles was hier steht funktioniert auch so. Am besten im Backend in der Feldkonfiguration schauen und dort die Pfade anpassen.
Ordner:
site/modules/InputfieldCKEditor/
Konfiguration gültig '''für alle Felder im Backend''' (hat bei mir bisher nicht ohne die Backendkonfiguration für das Feld funktioniert)
config.js
Konfiguration für ein bestimmtes Feld falls vorhanden
config.[fieldname.]js
mystyles.js -> ein selbstbenanntes Feld kann im Backend bei der Konfiguration des CKEditor Feldes angegeben werden.

Allgemeine Konfiguration. Z.B. Styles hinzufügen, removeFormatTags,

'''Alles was der Editor beim Eingeben mit '''JavaScript''' bearbeitet. Außerdem '''Style Auswahl anpassen''' alle Optionen die mit '''CKEDITOR.''' anfangen
content.css'''

'''Stile die der Editor bei der Eingabe benutzt. Also quasi die Vorschau für den Benutzer.'''
contents-inline.css

'''Stile für die Vorschau beim Inline Editor'''
Feldkonfiguration im Admin Bereich PW

Hier muß die '''Toolbar''' eingestellt werden. Über Konfig hat es bisher nicht geklappt. Hier muss auch die '''CSS Datei für die Inline Styles''' angegeben werden.

'''Überschreiben in der config.js''' hat bei mir nicht funktioniert - in aktueller Version 3.062 klappt es..

Auch '''Plugins''' müssen hier ausgewählt werden, damit sie eingebunden werden. Dies funktioniert also alles nur auf Feld-Ebene und nicht global.
=== CKEditor Buttons anpassen===
Wenn man ein Textarea Feld definiert, kann man auch für dieses Feld den CKEditor anpassen. Das geht im Backend in der '''Feldkonfiguration unter dem Reiter Eingabe.
'''
Beispiel: Hier werden '''Buttons für die Textausrichtung hinzugefügt.'''
<pre>
Format, Styles, -, Bold, Italic,Superscript, -,JustifyLeft,JustifyCenter,JustifyRight,-, RemoveFormat
NumberedList, BulletedList, -, Blockquote
PWLink, Unlink, Anchor

PWImage, Table, HorizontalRule, SpecialChar
PasteText, PasteFromWord,-,Undo,Redo
Scayt, -, Sourcedialog
</pre>

=== Default Einstellungen ===
Todo: TESTEN ob das wirklich funktioniert
Kann man im Modulverzeichnis unter site/modules hinterlegen. Achtung nicht im Modulverzeichnis unter wire überschreiben. Das ist beim nächsten Update weg.
/site/modules/InputfieldCKEditor/config.js -> überschreibt oder ergänzt die Default Einstellung
/site/modules/InputfieldCKEditor/config.body.js -> überschreibt oder ergänzt das body Feld
Beispiele:
config.startupOutlineBlocks = true;
<pre>

CKEDITOR.editorConfig = function( config ) {
config.justifyClasses = [ 'left', 'center', 'right', 'justify' ];
};
</pre>

Leider funktionieren viele Einstellungen hier nicht, die im original CKEditor möglich sind.

=== Eigene Styles ===
Eigene Stile zur Auswahl im '''Styles''' Dropdown
site->modules->InputfieldCKEditor->mystyles.js
anpassen.
Im Backend den Pfad hinzufügen (siehe Beispiel unten)

=== Konfigurationsbeispiele ===
Im Adminbereich im content_main Feld:

==== CKEditor Toolbar ====
Added justify buttons...
<pre>
Format, Styles, -, Bold, Italic, Superscript, -,JustifyLeft ,JustifyCenter ,JustifyRight , -, RemoveFormat
NumberedList, BulletedList, -, Blockquote

PWLink, Unlink, Anchor, PWImage, Table, HorizontalRule, SpecialChar
PasteText, PasteFromWord,-,Undo,Redo
Scayt, -, Sourcedialog
</pre>

Blöcke anzeigen, Smileys
<pre>
Format, Styles, -, Bold, Italic, Underline, Strike, Superscript, Subscript,
JustifyLeft ,JustifyCenter ,JustifyRight , -,
NumberedList, BulletedList, -, Blockquote

PWLink, Unlink, Anchor, PWImage, Table, HorizontalRule, SpecialChar, Smiley, ShowBlocks, RemoveFormat,
PasteText, PasteFromWord,-, Undo, Redo, -, Sourcedialog
</pre>

==== Custom Editor CSS File ====
Für die '''im Editor angezeigten Stile'''
site/modules/InputfieldCKEditor/contents.css
<syntaxhighlight lang="css">
@import url('../../templates/vendors/fa/css/font-awesome.min.css');
@import url('../../templates/vendors/bootstrap/css/bootstrap.min.css');
@import url('../../templates/css/main.css');

.cke_editable {
font-size: 14px;
line-height: 1.6em;
}

.cke_contents_ltr blockquote {
padding-left: 20px;
padding-right: 8px;
border-left-width: 5px;
}

.cke_contents_rtl blockquote {
padding-left: 8px;
padding-right: 20px;
border-right-width: 5px;
}
</syntaxhighlight>

==== Custom Editor JS File ====

Für die Auswahlfelder in der '''Toolbar'''
customstyles:/site/modules/InputfieldCKEditor/mystyles.js
<syntaxhighlight lang="javascript">
CKEDITOR.stylesSet.add( 'mystyles', [
{ name: 'Home Icon', element: 'i', attributes: {'class': 'fa fa-home fa-2x'}},
{ name: 'Panel Title', element: 'h4', attributes: {'class': 'panel-title'} },
]);
CKEDITOR.dtd.$removeEmpty['i'] = false; // leere i Tags erlauben (für font awesome)
</syntaxhighlight>

==== config.js ====
In /site/modules/InputfieldCKEditor/config.js (oder config.feldname.js)
<syntaxhighlight lang="javascript">
CKEDITOR.editorConfig = function( config ) {
config.uiColor = '#AADC6E';
config.coreStyles_italic = { element : 'i', overrides : 'em' }; // i nicht durch em überschreiben (für font awesome)
</syntaxhighlight>

== Plugins hinzufügen ==
https://weekly.pw/issue/13/#1-2 -> Plugins für CK Editor etc.
Readme im Plugins Ordner
=== Beispiel DIV Plugin ===
Wenn man mehrere Absätze auswählt und im Styles Menü einen Block-Style auswählt umschließt der CKEditor jeden Absatz mit dem Style.
Das Div Plugin ermöglicht es auch mehrere Blöcke mit einem einzigen Div zu umschließen. So kann man z.B. Kästchen über mehrere Absätze erzeugen.

# Plugin herungerladen und entpacken https://ckeditor.com/cke4/addon/div
# Ordner in site/modules/InputfieldCKEditor/plugins kopieren
# Modul in den Field Settings aktivieren (evtl. geht auch ''config.extraPlugins = 'div';'' in der config.js hinzuzufügen - nicht getestet.

== Probleme beheben ==
=== Bilder - width Attribut beschränkt auf max. 1200px ===

Suchbegriffe: CKEditor Bilder max 1200

https://processwire.com/talk/topic/9615-skip-width-attributes-on-img/
Der HTML Purifier ist hier das eigentliche Problem. Er beschränkt den Wert auf max 1200. Entweder den HTML Purifier abschalten (in der Feldkonfiguration) oder
wire/modules/Markup/MarkupHTMLPurifier/htmlpurifier/standalone/HTMLPurifier/ConfigSchema/schema.ser
There look for this bit... "HTML.MaxImgLength";i:1200
Change 1200 to your desired maximum value.

=== Cursor springt an den Anfang zurück ===

=== Eigene Styles funktionieren nicht ===
* customstyles statt mystyles als Bezeichner (ganz vorne in der Config) und in der myStyles.js
* Ich hatte Probleme wenn die Datei in site/templates/InputfieldCKEditor lag besser in site/modules/InputfieldCKEditor/

=== Editor wird nicht mehr im Backend angezeigt ===
Hat meistens mit der Konfiguration der myStyles.js zu tun (falscher Pfad o.ä.)

ProcessWire - Installation

2025-03-01T11:42:15Z

109.193.152.88: /* Datenbankfehler COLLATION 'utf8_general_ci' is not valid for CHARACTER SET 'utf8mb4' */

== Probleme beim Installieren beheben ==

=== 500 Internal Server Error ===
Häufigstes Problem ist ein '''500er Fehler sobald man Unterseiten aufruft'''. Die Starseite funktioniert aber. In dem Fall müssen die Optionen 19 und 20 in der htaccess angepasst werden (s.u.) Tritt z.B. beim Weiland Hosting auf.

<pre>
# -----------------------------------------------------------------------------------------------
# 19. Pass control to ProcessWire if all the above directives allow us to this point.
# For regular VirtualHosts (most installs)
# -----------------------------------------------------------------------------------------------
# RewriteRule ^(.*)$ index.php?it=$1 [L,QSA]

# -----------------------------------------------------------------------------------------------
# 20. If using VirtualDocumentRoot (500 NOTE): comment out the one above and use this one instead
# -----------------------------------------------------------------------------------------------
RewriteRule ^(.*)$ /index.php?it=$1 [L,QSA]

</pre>
=== Filecache und Modulcache leeren ===
Wenn man die Daten pur auf den Server spielt kann es beim Cachning zu Problemen kommen. Auch hier kann ein 500er Fehler auftauchen.

Wenn auch das nichts hilft einfach alles nochmal hochspielen.
Inkl. Datenbank /wire /site

=== Datenbankfehler COLLATION 'utf8_general_ci' is not valid for CHARACTER SET 'utf8mb4' ===
SQLSTATE[42000]: Syntax error or access violation: 1253 COLLATION 'utf8_general_ci' is not valid for CHARACTER SET 'utf8mb4'
tritt auf wenn die Voreinstellung der Datenbank nicht passt.

Lösung: Im Installer DB Charset auf utf-8 umstellen.

== Installation in Unterordner ==
You should uncomment this line in .htaccess and change "pw" to the name of your folder
RewriteBase /pw/

ProcessWire - Installation

2025-03-01T11:28:26Z

109.193.152.88: /* Probleme beim Installieren beheben */

== Probleme beim Installieren beheben ==

=== 500 Internal Server Error ===
Häufigstes Problem ist ein '''500er Fehler sobald man Unterseiten aufruft'''. Die Starseite funktioniert aber. In dem Fall müssen die Optionen 19 und 20 in der htaccess angepasst werden (s.u.) Tritt z.B. beim Weiland Hosting auf.

<pre>
# -----------------------------------------------------------------------------------------------
# 19. Pass control to ProcessWire if all the above directives allow us to this point.
# For regular VirtualHosts (most installs)
# -----------------------------------------------------------------------------------------------
# RewriteRule ^(.*)$ index.php?it=$1 [L,QSA]

# -----------------------------------------------------------------------------------------------
# 20. If using VirtualDocumentRoot (500 NOTE): comment out the one above and use this one instead
# -----------------------------------------------------------------------------------------------
RewriteRule ^(.*)$ /index.php?it=$1 [L,QSA]

</pre>
=== Filecache und Modulcache leeren ===
Wenn man die Daten pur auf den Server spielt kann es beim Cachning zu Problemen kommen. Auch hier kann ein 500er Fehler auftauchen.

Wenn auch das nichts hilft einfach alles nochmal hochspielen.
Inkl. Datenbank /wire /site

=== Datenbankfehler COLLATION 'utf8_general_ci' is not valid for CHARACTER SET 'utf8mb4' ===
SQLSTATE[42000]: Syntax error or access violation: 1253 COLLATION 'utf8_general_ci' is not valid for CHARACTER SET 'utf8mb4'
tritt auf wenn die Voreinstellung der Datenbank nicht passt.

Lösung:

== Installation in Unterordner ==
You should uncomment this line in .htaccess and change "pw" to the name of your folder
RewriteBase /pw/