Added option for other content fields

Author: splorp

index.php

@@ -9,13 +9,17 @@
 			'action' => function () {
 
 				$prefix = option('splorp.paperback-export.prefix', '');
+				$fields = option('splorp.paperback-export.fields', []);
 				$includeUnlisted = option('splorp.paperback-export.includeUnlisted', true);
 				$includeChildren = option('splorp.paperback-export.includeChildren', []);
 				$excludeTemplate = option('splorp.paperback-export.excludeTemplate', []);
 
 				if (! is_string($prefix)) {
 					throw new Exception('The option “splorp.paperback-export.prefix” must be a string.');
 				}
+				if (! is_array($fields)) {
+					throw new Exception('The option “splorp.paperback-export.fields” must be an array.');
+				}
 				if (! is_bool($includeUnlisted)) {
 					throw new Exception('The option “splorp.paperback-export.includeUnlisted” must be a boolean.');
 				}
@@ -51,7 +55,7 @@
 				$pages = $pages->filterBy('intendedTemplate', 'not in', $excludeTemplate);
 
 				$template  = __DIR__ . '/snippets/export.php';
-				$paperback = tpl::load($template, compact('languages', 'pages', 'title', 'description', 'prefix', 'version', 'datestamp', 'filename'));
+				$paperback = tpl::load($template, compact('languages', 'pages', 'title', 'description', 'prefix', 'fields', 'version', 'datestamp', 'filename'));
 
 				return new response($paperback, 'txt');
 			}

readme.md

@@ -65,9 +65,33 @@ return [
 ];
 ```
 
-### Include unlisted pages
+### Include Other Content Fields
 
-By default, text located in the `$page->title()` and `$page->text()` fields for every page on your Kirby site will be included in the exported data. The following options can be added to the `site/config/config.php` file, allowing you to filter which pages are included based on certain criteria.
+By default, text located in the `$page->title()` and `$page->text()` fields will be included in the exported data. The following option can be added to the `site/config/config.php` file, allowing you to specify other content fields to be included. These fields will be appended after the title and text fields.
+
+This option is not set by default.
+
+```php
+return [
+	'splorp.paperback-export.fields' => [],
+];
+```
+
+Specify one or more content fields and their type as an array.
+
+```php
+return [
+	'splorp.paperback-export.fields' => ['author' => 'text','posts' => 'related'],
+];
+```
+
+Use the `text` content type for any field containing alphanumberic data, such as an author name or date.
+
+Use the `related` content type for fields formatted using the YAML syntax for [related articles](https://getkirby.com/docs/cookbook/content/related-articles). The title field of each related article or page will be included in the exported data.
+
+### Include Unlisted Pages
+
+By default, every page on your Kirby site will be included in the exported data. The following options can be added to the `site/config/config.php` file, allowing you to filter which pages are included based on certain criteria.
 
 This option is set to true by default.
 

snippets/content.php

@@ -10,11 +10,22 @@
 	// Remove all remaining tags
 	$buffer = html_entity_decode(strip_tags($buffer));
 	echo $buffer . PHP_EOL . PHP_EOL;
-	if($page->source()->exists()) {
-		if($page->source()->toPages()->count() > 1) { echo 'Sources: ' . PHP_EOL; } else { echo 'Source: '; }
-		$n=0; foreach($page->source()->toPages() as $source): $n++;
-		echo $source->title() . PHP_EOL;
-		endforeach;
-		echo PHP_EOL;
-	}
+	// Determine other content fields
+	foreach ($fields as $fieldname => $fieldtype) :
+ 		if($page->content()->get($fieldname)->isNotEmpty()) {
+ 			echo ucwords($fieldname) . ': ';
+ 			if($fieldtype == 'related') {
+				$n = false;
+				foreach($page->content()->get($fieldname)->toPages() as $fieldpage):
+					if ($n) : echo ', ';
+					endif;
+					echo $fieldpage->title();
+					$n = true;
+				endforeach;
+				echo PHP_EOL . PHP_EOL;
+			} else {
+ 				echo $page->content()->get($fieldname) . PHP_EOL . PHP_EOL;
+			}
+		}
+	endforeach;
 ?>

snippets/export.php

@@ -6,6 +6,6 @@
 	if ($version != '') { echo ('Version ' . $version . ' (' . $datestamp . ')'); } else { echo ('Published ' . $datestamp); }
 	echo (PHP_EOL . PHP_EOL);
 	foreach ($pages as $page) :
-		snippet('paperback-export/content', compact('languages', 'page', 'prefix'));
+		snippet('paperback-export/content', compact('languages', 'page', 'prefix', 'fields'));
 	endforeach;
 ?>