feat: add ability to add cutoms items to head

yaroslav8765 · yaroslav8765 · commit d9da15410148 · 2025-07-28T16:05:56.000+03:00
diff --git a/adminforth/modules/codeInjector.ts b/adminforth/modules/codeInjector.ts
@@ -545,8 +545,21 @@ class CodeInjector implements ICodeInjector {
           ||
        `/assets/favicon.png`
     );
-    await fs.promises.writeFile(indexHtmlPath, indexHtmlContent);
 
+    // inject heads to index.html
+    const headItems = this.adminforth.config.customization!.customHeadItems;
+    const renderedHead = headItems.map(({ tagName, attributes }) => {
+      const attrs = Object.entries(attributes)
+        .map(([k, v]) => `${k}="${v}"`)
+        .join(' ');
+      const isVoid = ['area', 'base', 'br', 'col', 'embed', 'hr', 'img', 'input', 'link', 'meta', 'source', 'track', 'wbr'].includes(tagName);
+      return isVoid
+        ? `<${tagName} ${attrs}>`
+        : `<${tagName} ${attrs}></${tagName}>`;
+    }).join('\n    ');
+
+    indexHtmlContent = indexHtmlContent.replace("/* IMPORTANT:ADMINFORTH HEAD */", `${renderedHead}` );
+    await fs.promises.writeFile(indexHtmlPath, indexHtmlContent);
 
     /* generate custom routes */
     let homepageMenuItem: AdminForthConfigMenuItem = findHomePage(this.adminforth.config.menu);
diff --git a/adminforth/spa/index.html b/adminforth/spa/index.html
@@ -14,7 +14,7 @@
           document.documentElement.classList.remove('dark')
       }
   </script> -->
-
+    /* IMPORTANT:ADMINFORTH HEAD */
   </head>
   <body class="min-h-screen flex flex-col">
     <div id="app" class="grow bg-lightHtml dark:bg-darkHtml w-full"></div>
diff --git a/adminforth/types/Back.ts b/adminforth/types/Back.ts
@@ -764,6 +764,12 @@ interface AdminForthInputConfigCustomization {
     sidebar?: AdminForthComponentDeclaration | Array<AdminForthComponentDeclaration>,
     everyPageBottom?: AdminForthComponentDeclaration | Array<AdminForthComponentDeclaration>,
   }
+
+  customHeadItems?: {
+    tagName: string;
+    attributes: Record<string, string | boolean>;
+  }[];
+
 }
 
 export interface AdminForthActionInput {
@@ -1069,6 +1075,12 @@ export interface AdminForthConfigCustomization extends Omit<AdminForthInputConfi
     sidebar: Array<AdminForthComponentDeclarationFull>,
     everyPageBottom: Array<AdminForthComponentDeclarationFull>,
   },
+
+  customHeadItems?: {
+    tagName: string;
+    attributes: Record<string, string | boolean>;
+  }[];
+  
 }
 
 export interface AdminForthConfig extends Omit<AdminForthInputConfig, 'customization' | 'resources'> {

Original file line number	Diff line number	Diff line change
`@@ -14,7 +14,7 @@`
`14`	`14`	`document.documentElement.classList.remove('dark')`
`15`	`15`	`}`
`16`	`16`	`</script> -->`
`17`		`-`
	`17`	`+ /* IMPORTANT:ADMINFORTH HEAD */`
`18`	`18`	`</head>`
`19`	`19`	`<body class="min-h-screen flex flex-col">`
`20`	`20`	`<div id="app" class="grow bg-lightHtml dark:bg-darkHtml w-full"></div>`