Add Children "only, includeFolders, reverse" flags, add document unhideSelf (#209)

gatsby-node.js

@@ -51,6 +51,7 @@ exports.onCreateNode = async ({ node, getNode, getNodesByType, actions, createNo
   const docTitle = fileToTitle(fileTitle);
   const slug = createSlug(filePath, version);
   const parentSlug = `${path.resolve(slug, '../')}/`;
+  const unhideSelf = false;
 
   const docData = {
     isIndex,
@@ -58,6 +59,7 @@ exports.onCreateNode = async ({ node, getNode, getNodesByType, actions, createNo
     fileTitle,
     slug,
     parentSlug,
+    unhideSelf,
     ...node.frontmatter,
   };
 

src/components/ChildrenOf.tsx

@@ -38,33 +38,40 @@ const createList = (children: SilverstripeDocument[]): ReactElement[] => {
     });
 };
 
-const ChildrenOf: StatelessComponent<ChildrenOfProps> = ({ folderName, exclude, currentNode, asList }) => {
+const ChildrenOf: StatelessComponent<ChildrenOfProps> = ({ folderName, exclude, only, currentNode, asList, includeFolders, reverse }) => {
     if (!currentNode) {
         return null;
     }
-    let children: ReactElement[] = [];
-    if (!folderName && !exclude) {
-        const sourceNodes = currentNode.isIndex ? getChildren(currentNode, false) : getSiblings(currentNode)
-        children = asList ? createList(sourceNodes) : createCards(sourceNodes);
+
+    var nodes: SilverstripeDocument[] = [];
+
+    if (!folderName && !exclude && !only) {
+        nodes = currentNode.isIndex ? getChildren(currentNode, false) : getSiblings(currentNode)
+
     } else if (folderName) {
         const targetFolder = getChildren(currentNode, true).find(
             child => child.isIndex && child.fileTitle.toLowerCase() === folderName.toLowerCase()
         );
         if (targetFolder) {
-            children = asList
-                ? createList(getChildren(targetFolder, false))
-                : createCards(getChildren(targetFolder, false));
-        } else {
-            children = [];
+            nodes = getChildren(targetFolder, false);
         }
     } else if (exclude) {
         const exclusions = exclude.split(',').map(e => e.toLowerCase());
-        const nodes = getChildren(currentNode, false).filter(
+        nodes = getChildren(currentNode, includeFolders).filter(
             child => !exclusions.includes(child.fileTitle.toLowerCase())
         );
-        children = asList ? createList(nodes) : createCards(nodes);
+    } else if (only) {
+        const inclusions = only.split(',').map(e => e.toLowerCase());
+        nodes = getChildren(currentNode, includeFolders).filter(
+            child => inclusions.includes(child.fileTitle.toLowerCase())
+        );
     }
 
+    if (reverse) {
+        nodes.reverse();
+    }
+    let children: ReactElement[] = asList ? createList(nodes) : createCards(nodes);
+
     return (
         <div className="docs-overview py-5">
             {asList &&

src/types/index.ts

@@ -33,6 +33,7 @@ export interface SilverstripeDocument {
     iconBrand?: string;
     hideChildren?: boolean;
     hideSelf?: boolean;
+    unhideSelf?: boolean;
     parentSlug: string;
     summary: string;
     fileTitle: string;
@@ -48,6 +49,9 @@ export interface HierarchyQuery {
 export interface ChildrenOfProps {
     folderName?: string;
     exclude?: string;
+    only?: string;
     currentNode: SilverstripeDocument | null;
     asList?: boolean;
+    includeFolders?: boolean;
+    reverse?: boolean;
 };

src/utils/nodes.ts

@@ -31,6 +31,7 @@ const getNodes = (): SilverstripeDocument[] => {
             icon
             iconBrand
             hideChildren
+            unhideSelf
             slug
             parentSlug
             fileTitle
@@ -87,6 +88,8 @@ const getNavChildren = (node: SilverstripeDocument): SilverstripeDocument[] => {
     children = getChildren(node, true).filter(n => !n.hideSelf);
   }
 
+  getChildren(node, true).filter(n => n.unhideSelf).forEach(c => children.push(c));
+
   navChildrenMap.set(node.slug, children);
 
   return navChildrenMap.get(node.slug);

src/utils/parseChildrenOf.ts

@@ -9,23 +9,38 @@ import { getCurrentNode } from '../utils/nodes';
 const parseChildrenOf = (data: any): ReactElement|false => {
     const currentNode = getCurrentNode();
     let matches;
-    matches = data.match(/\[CHILDREN(\sasList)?\]/);
-    if (matches) {
-        const asList = !!matches[1];
-        return createElement(ChildrenOf, { currentNode, asList })
-    }
 
     matches = data.match(/\[CHILDREN Folder="?([A-Za-z0-9_<>\/]+)"?.*?\]/);
     if (matches) {
         const folderName = matches[1].replace(/<\/?em>/g, '_');
         const asList = matches[0].match(' asList');
-        return createElement(ChildrenOf, { folderName, currentNode, asList })
+        const includeFolders = matches[0].match(' includeFolders');
+        const reverse = matches[0].match(' reverse');
+        return createElement(ChildrenOf, { folderName, currentNode, asList, includeFolders, reverse })
     }
     matches = data.match(/\[CHILDREN Exclude="?([A-Za-z0-9_,]+)"?.*?\]/);
     if (matches) {
         const asList = matches[0].match(' asList');
+        const includeFolders = matches[0].match(' includeFolders');
+        const reverse = matches[0].match(' reverse');
         const exclude = matches[1].replace(/<\/?em>/g, '_');
-        return createElement(ChildrenOf, { exclude, currentNode, asList })
+        return createElement(ChildrenOf, { exclude, currentNode, asList, includeFolders, reverse })
+    }
+    matches = data.match(/\[CHILDREN Only="?([A-Za-z0-9_,]+)"?.*?\]/);
+    if (matches) {
+        const asList = matches[0].match(' asList');
+        const includeFolders = matches[0].match(' includeFolders');
+        const reverse = matches[0].match(' reverse');
+        const only = matches[1].replace(/<\/?em>/g, '_');
+        return createElement(ChildrenOf, { only, currentNode, asList, includeFolders, reverse })
+    }
+    matches = data.match(/\[CHILDREN(\sasList)?.*?\]/);
+    if (matches) {
+        const asList = !!matches[1];
+        const includeFolders = matches[0].match(' includeFolders');
+        const reverse = matches[0].match(' reverse');
+
+        return createElement(ChildrenOf, { currentNode, asList, includeFolders, reverse })
     }
 
     return false;