Hello World Deluxe

Let’s use what we’ve learned to remix the zem_hello_world tag handler. We’ll fix the HTML encoding bug, and — introducing another built-in Textpattern function, doTag — add new wraptag and class attributes.

function zem_hello_deluxe($atts) {
   extract(lAtts(array(
      'name'  => 'Alice',
      'wraptag' => '',
      'class' => "hello",
   ),$atts));

   return doTag(htmlspecialchars($name), $wraptag, $class);
}

@doTag@ accepts three arguments: @$content@, @$tag@, @$class@.  It encloses the content with the specified tag, using the CSS class name.  It's smart enough to behave appropriately when the tag or class values are empty.

<txp:zem_hello_deluxe name="Alice & Bob" />

Alice & Bob

<txp:zem_hello_deluxe name="Alice & Bob" wraptag="div" />

<div class="hello">Alice &amp;amp; Bob</div>

<txp:zem_hello_deluxe wraptag="p" class="" />

<p>Alice</p>

Next, in part 4: debugging essentials, and enclosing tags.

¹ There’s no official pegistry of plugin developer prefixes. Check the Central Plugin Registry for clashes.

² As of Textpattern 4.0.4, dmp allows any number of arguments, like dmp('my atts', $atts);. In prior versions, only a single argument is supported.