Zum Hauptinhalt springen

Tutorial: Erstelle ein eigenes Custom Field Plugin - params/owlimg.xml

Geschrieben von Elisa Foltyn

Dieses Joomla! Custom Field Plugin zeigt Bilder aus einem ausgewählten Ordner in einem "Owl Carousel" an. In diesem Tutorial erkläre ich dir wie du ein solches "Eigenes Feld Plugin" selbst bauen kannst. 

params/owlimg.xml

In der params/owlimg.xml Datei können wir innerhalb des Feldes selbst Parameter ändern. Wir kopieren hier kurzerhand unsere Felder aus der owlimg.xml Hauptdatei und fügen weitere Optionen hinzu.

<?xml version="1.0" encoding="utf-8"?>
<form>
	<fields name="fieldparams">
		<fieldset name="fieldparams">

			<field
			       name="customclass"
			       type="text"
			       label="PLG_FIELDS_OWLIMG_CUSTOMCLASS"
			       desc="PLG_FIELDS_OWLIMG_CUSTOMCLASS_DESC"
			       filter="cmd"
			       default="myowl"
			/>

			<field 
			       name="layouthead"
			       type="spacer" 
			       label="PLG_FIELDS_OWLIMG_LAYOUTHEAD"
			/>

			<field
			       name="items"
			       type="number"
			       label="PLG_FIELDS_OWLIMG_ITEMS"
			       min="1"
			       step="1"
			       hint="PLG_FIELDS_OWLIMG_LEAVE_EMPTY"
			/>

			<field
			       name="animatein"
			       type="groupedlist"
			       label="PLG_FIELDS_OWLIMG_ANIMATEIN"
			       showon="items:1"
			>
				<option value="">COM_FIELDS_FIELD_USE_GLOBAL</option>
					<group label="Attention Seekers">
						<option value="bounce">bounce</option>
						<option value="flash">flash</option>
						<option value="pulse">pulse</option>
						<option value="rubberBand">rubberBand</option>
						<option value="shake">shake</option>
						<option value="swing">swing</option>
						<option value="tada">tada</option>
						<option value="wobble">wobble</option>
						<option value="jello">jello</option>
					</group>


...etc

Du siehst, in der params/owlimg.xml benutzen wir zum einen kein default Attribut, wie in der Manifest Datei, denn den default Wert wollen wir uns ja aus den globalen Plugin Paramatern ziehen. Außerdem füge ich hier in den Hinweistext (Hint) ein, dass der User das Feld leer lassen soll, um die globalen Parameter zu übernehmen.

Sehe dir am besten die params/owlimg.xml Datei im Downloadpaket nochmal genauer an und vergleiche die Feldeinstellungen mit der Manifestdatei.

Wird Zeit, dass wir uns kennenlernen!