Merge pull request #379 from devforth/ScriptInHtmlHead

feat: add possibility to add inner code in html head elements

Author: yaroslav8765

adminforth/documentation/docs/tutorial/03-Customization/08-pageInjections.md

@@ -554,4 +554,24 @@ new AdminForth({
 })
 ```
 
-If you hide the logo with `showBrandLogoInSidebar: false`, components injected via `sidebarTop` will take the whole line width.
+If you hide the logo with `showBrandLogoInSidebar: false`, components injected via `sidebarTop` will take the whole line width.
+
+## Custom scripts in head
+
+If you want to inject tags in your html head:
+
+```ts title='./index.ts'
+
+customization: {
+  ...
+  customHeadItems: [
+    {
+      tagName: 'script',
+      attributes: { async: 'true', defer: 'true' },
+      innerCode: "console.log('Hello from HTML head')"
+    }
+  ],
+...
+}
+
+```

adminforth/modules/codeInjector.ts

@@ -570,14 +570,14 @@ class CodeInjector implements ICodeInjector {
     // inject heads to index.html
     const headItems = this.adminforth.config.customization?.customHeadItems;
     if(headItems){
-      const renderedHead = headItems.map(({ tagName, attributes }) => {
+      const renderedHead = headItems.map(({ tagName, attributes, innerCode }) => {
       const attrs = Object.entries(attributes)
         .map(([key, value]) => `${key}="${value}"`)
         .join(' ');
       const isVoid = ['base', 'link', 'meta'].includes(tagName);
       return isVoid
         ? `<${tagName} ${attrs}>`
-        : `<${tagName} ${attrs}></${tagName}>`;
+        : `<${tagName} ${attrs}> ${innerCode} </${tagName}>`;
       }).join('\n    ');
 
       indexHtmlContent = indexHtmlContent.replace("    <!-- /* IMPORTANT:ADMINFORTH HEAD */ -->", `${renderedHead}` );

adminforth/spa/src/spa_types/core.ts

@@ -49,6 +49,7 @@ export type CoreConfig = {
     customHeadItems?: {
         tagName: string;
         attributes: { [key: string]: string | boolean };
+        innerCode?: string;
     }[],
 }
 

adminforth/types/Back.ts

@@ -811,6 +811,7 @@ interface AdminForthInputConfigCustomization {
   customHeadItems?: {
     tagName: string;
     attributes: Record<string, string | boolean>;
+    innerCode?: string;
   }[];
 
 }
@@ -1140,6 +1141,7 @@ export interface AdminForthConfigCustomization extends Omit<AdminForthInputConfi
   customHeadItems?: {
     tagName: string;
     attributes: Record<string, string | boolean>;
+    innerCode?: string;
   }[];
 
 }

adminforth/types/Common.ts

@@ -1108,6 +1108,7 @@ export interface AdminForthConfigForFrontend {
   customHeadItems?: {
     tagName: string;
     attributes: Record<string, string | boolean>;
+    innerCode?: string;
   }[],
   settingPages?:{
     icon?: string,