figcaption: Adds figcaption

Wraps images with title or data-attribution attribute
in a figure element.
Places the title in a figcaption element.
Places the data-attribution in a small element.

Author: laurensmartina

index.php

@@ -125,6 +125,7 @@
 	if ($hyphaPage) processCommandResult($hyphaPage->process($O_O->getRequest()));
 
 	registerPostProcessingFunction('dewikify');
+	registerPostProcessingFunction('add_captions_to_all_images');
 
 	// add hypha commands and navigation
 	$_cmds[] = '<a class="index" href="index/'.$hyphaLanguage.'">'.__('index').'</a>';

system/core/pages.php

@@ -601,6 +601,34 @@ function wikify_link($node) {
 			$node->text('');
 	}
 
+	function add_captions_to_all_images($element) {
+		/** @var \DOMWrap\NodeList $img */
+		// process images that reside within "main"
+		foreach ($element->findXPath('//*[@id="main"]//img[@title] | //*[@id="main"]//img[@data-attribution]') as $img) {
+			// do not process images that reside within the wymeditor
+			if ($img->parents('.wymeditor')->count() === 0) {
+				add_caption_to_image($img);
+			}
+		}
+	}
+
+	function add_caption_to_image($img) {
+		$figure = new DOMWrap\Element('figure');
+		$img->parentNode->insertBefore($figure, $img);
+		$figure->append($img);
+
+		$title = $img->getAttribute('title');
+		$text = $title ? $title : '';
+		$caption = new DOMWrap\Element('figcaption', $text);
+		$figure->append($caption);
+
+		$attribution = $img->getAttribute('data-attribution');
+		if ($attribution) {
+			$small = new DOMWrap\Element('small', $attribution);
+			$figure->append($small);
+		}
+	}
+
 	/*
 		Function: versionSelector
 		generate html select element with available revisions for given page