Archiv der Kategorie: Typo3

typo3 extension builder missing extension root storagepath in folder select

If you can not save your new created extension to a correct path then maybe a additional first entry in your project composer.json is needed.

"repositories": 
  [ 
    { "type": "path", "url": "./packages" },
    ...
    ...
  ]

There will be now a „root“ storagePath an the extension could be saved in the correct location. In my case without this config it would be accidently saved nested into the folder of another extension.

TYPO3 Version
10.4.23 composer mode

Extension Builder Version:
git v10.0.3

TYPO3: BodyTag mit CSS Klassen für Page Id und Page Template

Folgend ein kleiner TypoScript Snippet um den BodyTag mit zusätzlichen Klassen zu rendern.

Eine ist mehr informativ und gibt die Page ID aus z.B. „pid-123“. Die andere gibt das aktuell ausgewählte bzw. „vererbte“ Seitentemplate von fluidpages aus und kann für Stylingzwecke gut gebraucht werden.

Der TypoScript Kenner kann dies leicht z.B. für FLUIDTEMPLATE umschreiben.

page {
    bodyTag >
    bodyTagCObject = COA
    bodyTagCObject {
        10 = TEXT
        10 {
            data = page:uid
            stdWrap.noTrimWrap = |pid-| |
        }

        20 = TEXT
        20 {
            if.isTrue.data = page:tx_fed_page_controller_action
            data = page:tx_fed_page_controller_action
            split {
                token = >
                returnKey = 1
            }
            case = lower
        }
        20.wrap = tmpl-|

        30 = TEXT
        30 {
            if.isFalse.data = page:tx_fed_page_controller_action
            data = levelfield:-2, tx_fed_page_controller_action, slide
            split {
                token = >
                returnKey = 1
            }
            case = lower
        }
        30.wrap = tmpl-|
    }
    bodyTagCObject {
        wrap = <body class="|">
    }
}

 

TYPO3: Fluid Powered TYPO3 – Custom Flux Controller

FluidTYPO3 alleine ist schon eine geniale Lösung. Damit ist es ein leichtes Seitentemplates und Contentelemente anzulegen.

Im Hintergrund arbeitet Flux und übergibt automatisch die wichtigsten Daten für das Frontendrendering.

Bei Seiten sind dies alle benötigten Daten zu Seiteneigenschaften, bei Contentelementen alle benötigten Daten aus den gepflegten Feldern der Flexform des Contentelements und noch einiges mehr.

Für den Fall dass dies nicht ausreichen sollte gibt es die Möglichkeit in der Providerextension einen „Custom Flux Controller“ anzulegen.

In diesem ist es möglich zusätzliche Daten an die View zu übergeben, die nicht durch Flux geliefert werden.

Wie dies genutzt werden kann will ich folgend kurz beschreiben.

Zunächst müssen im Ordner „Classes/Controller“ zwei Controller Dateien angelegt werden:

  • ContentController.php
  • PageController.php

Beispielcode zum ContentController:

<?php
namespace Yourvendorname\Yourextensionkey\Controller;

use FluidTYPO3\Flux\Controller\AbstractFluxController;

/**
 * Additional ContentController
 *
 * As default Flux generates internally a ContentController an assigns most common objects to the view.
 * If a custom ContentController with a known action is found. Flux will execute the action additionally (performSubRendering).
 *
 * @package Yourextensionkey
 * @subpackage Controller
 */
class ContentController extends AbstractFluxController
{


//    public function fooAction()
//    {
//        $this->view->assign('foo', 'bar');
//    }

}

Beispielcode zum PageController:

<?php
namespace Yourvendorname\Yourextensionkey\Controller;

use FluidTYPO3\Fluidpages\Controller\AbstractPageController;

/**
 * Additional PageController
 *
 * As default Flux generates internally a PageController an assigns most common objects to the view.
 * If a custom PageController with a known action is found. Flux will execute the action additionally (performSubRendering).
 *
 * @package Yourextensionkey
 * @subpackage Controller
 */
class PageController extends AbstractPageController {

//    public function fooAction()
//    {
//        $this->view->assign('foo', 'bar');
//    }

}

Dies allein sollte schon ausreichen um einen Custom Flux Controller für Page und Content anzulegen.

Für den Fall dass dies nicht ausreichen sollte muss wie hier beschrieben im Ordner „Migrations/Code“ die Datei ClassAliasMap.php angelegt werden.

<?php

return array(
	'Tx_Yourextensionkey_Controller_ContentController' => 'Yourvendorname\\Yourextensionkey\\Controller\\ContentController',
	'Tx_Yourextensionkey_Controller_PageController' => 'Yourvendorname\\Yourextensionkey\\Controller\\PageController',
);

 

Fluid Powered TYPO3 auf Github.

TYPO3: Fluid Powered TYPO3

Ich möchte hier kurz Fluid Powered TYPO3 vorstellen. Dieses war mir schön länger bekannt, nur leider habe ich die Genialität dahinter nicht verstanden. Mit dem Gedanken „wer braucht den bitte Flux“ habe ich dieses Thema immer schnell abgehakt.

FluidTYPO3 besteht aus einer Kombination diverser Extensions für TYPO3 CMS. flux, fluidcontent, fluidcontent_core, fluidpages und vhs bilden zusammen ein sehr geniales gespannt.

Diese müssen natürlich nicht allesamt genutzt werden. flux und fluidcontent alleine reichen schon aus um schnell flexible Contentelemente anzulegen. fluidpages weitet das ganze auf Seitentemplateebene aus. fluidcontent_core ersetzt css_styled_content. vhs selbst ist eine Sammlung von oft benötigten ViewHelpern.

Wie auf der Homepage von FluidTYPO3 zu lesen ist steht „convention-over-configuration“ im Vordergrund. Und das ist auch sehr genial umgesetzt.

Doch wie findet man einen einfachen Einstieg um dies zu nutzen? Fast ein wenig versteckt ist in der sehr umfangreichen Dokumentation die Extension „builder“ erwähnt. Ich persönlich hätte den builder mehr in einem QuickStart Tutorial hervor gehoben.

fluidtypo3-builder

Mit dieser ist es möglich wie zu den alten Extension Kickstarter Zeiten eine FluidTYPO3 „provider extension“ zu erstellen. Dies ist über ein Backend Modul möglich oder man nutzt dazu den CLI Dispatcher auf der Kommandozeile. Deren Grundgerüst sieht dann wie folgt aus:

provider-extension

Dies ist auf den ersten Blick eine ganz normale Extbase Ordnerstruktur, in der Datei ext_tables.php wird diese Extension als „Provider Extension“ bei Flux registriert und die Magie beginnt.

Als Beispiel sind über den Builder dort schon zwei Templates angelegt worden, diese sind zum einen ein Seiten-Template und zum anderen ein Contentelement-Template. Jedes weitere Template das im Ordner „Page“ oder „Content“ angelegt wird, wird automatisch im TYPO3 Backend als Seitentemplate oder als Contentelement zur Verfügung gestellt.

Hinzu kommt dass in diesen Template Dateien die komplette Konfiguration enthalten ist. Configuration (BE Eingabe), Preview (BE) und Main (FE rendering) sind dort zentral in einer Datei enthalten. Und das alles ohne eine einzige Zeile TypoScript!

Beispiel Konfigurationsdatei für ein Seitentemplate:

<div xmlns="http://www.w3.org/1999/xhtml" lang="en"
	xmlns:f="http://typo3.org/ns/TYPO3/Fluid/ViewHelpers"
	f:schemaLocation="https://fluidtypo3.org/schemas/fluid-master.xsd"
	xmlns:flux="http://typo3.org/ns/FluidTYPO3/Flux/ViewHelpers"
	flux:schemaLocation="https://fluidtypo3.org/schemas/flux-master.xsd"
	xmlns:v="http://typo3.org/ns/FluidTYPO3/Vhs/ViewHelpers"
	v:schemaLocation="https://fluidtypo3.org/schemas/vhs-master.xsd">
	<f:layout name="Page" />

	<f:section name="Configuration">
		<flux:form id="fluidpage" options="{icon: 'Icons/Page/Standard.gif'}">
			<!-- Insert fields, sheets, grid, form section objects etc. here, in this flux:form tag -->
		</flux:form>
		<flux:grid>
			<!-- Edit this grid to change the "backend layout" structure -->
			<flux:grid.row>
				<flux:grid.column colPos="0" colspan="3" name="main" />
				<flux:grid.column colPos="1" name="right" />
			</flux:grid.row>
		</flux:grid>
	</f:section>

	<f:section name="Main">
		<h1>I am a page template!</h1>
		<p>
			My template file is EXT:myprovider/Resources/Private/Page/Standard.html.
		</p>
		<div style="float: left; width: 75%;">
			<h2>Content main</h2>
			<v:content.render column="0" />
		</div>
		<div style="float: left; width: 25%;">
			<h2>Content right</h2>
			<v:content.render column="1" />
		</div>
	</f:section>
</div>

Beispiel einer Konfigurationsdatei für ein Contentelement:

<div xmlns="http://www.w3.org/1999/xhtml" lang="en"
	xmlns:f="http://typo3.org/ns/TYPO3/Fluid/ViewHelpers"
	f:schemaLocation="https://fluidtypo3.org/schemas/fluid-master.xsd"
	xmlns:flux="http://typo3.org/ns/FluidTYPO3/Flux/ViewHelpers"
	flux:schemaLocation="https://fluidtypo3.org/schemas/flux-master.xsd">
	<f:layout name="Content" />

	<f:section name="Configuration">
		<flux:form id="fluidcontent" options="{icon: 'Icons/Content/Example.gif', group: 'FCE'}">
			<!-- Insert fields, sheets, grid, form section objects etc. here, in this flux:flexform tag -->
		</flux:form>
	</f:section>

	<f:section name="Preview">
		<!-- uncomment this to use a grid for nested content elements -->
		<!-- <flux:widget.grid /> -->
	</f:section>

	<f:section name="Main">
		<h3>I am a content element!</h3>
		<p>
			My template file is EXT:myprovider/Resources/Private/Content/Example.html.
		</p>
	</f:section>
</div>

Im Hintergrund kümmert sich flux um alles und übergibt automatisch an die Templates (Views) alle benötigten Objekte für das Rendering im Frontend.

Wie schon erwähnt ein in meinen Augen ziemlich geniales Gespann mit dem man einfach, schnell und flexibel Seitentemplates und Contentelemente (FCE’s) anlegen kann.

Fluid Powered TYPO3 auf Github

TYPO3: RTE – Javascript in href nutzen

Manchmal möchte man gerne anstatt der zur Verfügung stehenden Linkmöglichkeiten des Wizards in RTE direkt eine Javascript Funktion aufrufen.

Wechselt man z.B. im Textelement im RTE in die HTML Ansicht, kann unten stehendes Markup einkopiert werden. Mit den zusätzlichen Attributen lässt der RTE das href Attribut in Ruhe und lässt dieses so wie es ist.

<a href="javascript:mySuperFunc()" data-htmlarea-external="1" rtekeep="1">JS href link in RTE</a>

 

Typoscript: csc stdWrap abhängig von CType entfernen

Ist zwar Abartig, aber es geht ^^ Hier ein paar Beispiele.

tt_content.stdWrap.innerWrap.cObject.default.if {
  equals.field = CType
  value = fluidcontent_content
  negate = 1
}
tt_content.stdWrap.innerWrap.cObject.default.if {
  equals.field = CType
  value = gridelements_pi1
  negate = 1
}
# unnötigen csc-default wrap um Inhaltselement Verweis entfernen
tt_content.stdWrap.innerWrap.cObject.default.if {
  equals.field = CType
  value = shortcut
  negate = 1
}

 

TYPO3: MySQL strict modes und TYPO3

TYPO3 Version 6.2 LTS ist gerade frisch raus und ich wollte dieses lokal auf meinen Rechner ausprobieren. Die Installation war schnell erledigt. Doch beim ersten einfügen eines Contentelements kam die Fehlermeldung „SQL error: ‚Field ‚filelink_sorting‘ doesn’t have a default value‘ (tt_content:NEW……..)“ im BE?

WTF, was ist das… bei einer gerade eben frisch eingerichteten TYPO3 Installation. Google war gnädig und hat mich dann doch gleich zum richtigen Ergebnis geleitet:

Document that TYPO3 CMS is not compatible with MySQL strict modes

Anscheinend gibt es Probleme mit der MySql Datenbank wenn diese mit Mode „STRICT_TRANS_TABLES“ oder „STRICT_ALL_TABLES“ konfiguriert ist.

# Dieser lässt sich  mit entsprechenden Rechten in der Datenbank ändern.
SET @@global.sql_mode=''

Der Vollständigkeit halber noch unten wie man diesen Modus setzt.

#As priv'd user, 

SET @@global.sql_mode='STRICT_TRANS_TABLES';
SET @@global.sql_mode='STRICT_ALL_TABLES';

Weiterführende Links:
http://forge.typo3.org/issues/54883
http://forge.typo3.org/issues/52206
https://www.netbrothers.de/typo3-projekte/typo3-tipps/typo3-mysql-strict-mode/

 

Extbase / Fluid: Inline Javascript einfügen?

Schön ist es vielleicht nicht wenn man in Extbase/Fluid Inline JavaScript ins Fluid-Template mit aufnehmen will. Aber in manchen Fällen kommt man einfach nicht drum herum ;-) Die Stelle an der es tricky wird ist wenn dynamische Werte mit der geschweiften Klammer in das JavaScript mit aufgenommen werden sollen.

In diesem Fall muss mit einem <![CDATA[ … ]]> gearbeitet werden.

<script type="text/javascript">
	<![CDATA[
	$(document).ready(function(){
		$('.selector]]>{myvalue}<![CDATA[').click()
	})
	]]>
</script>

Ein anderes Szenario ist wenn die eingefügten Inhalte ebenfalls JavaScript oder Json enthalten. Hier müssen die Daten mit dem Fluid „format.html“ ViewHelper eingefügt werden.

<script text="type/javascript"> 

var myObject= <f:format.html parseFuncTSPath="">{json}</f:format.html>

</script>