Aktualisiere README.md und Konfigurationsdateien für Version 1.0.4; füge Elemente für Custom Branding Application Customizer hinzu

.gitignore

@@ -1,32 +1,47 @@
+# Dependencies and local tools
+node_modules/
+.tools/
+
+# SPFx build output
+lib/
+dist/
+temp/
+release/
+solution/
+sharepoint/solution/
+*.sppkg
+*.tgz
+
+# Test output
+coverage/
+
+# Generated TypeScript files
+*.resx.ts
+*.scss.ts
+
 # Logs
-logs
+logs/
 *.log
 npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
 
-# Dependency directories
+# Local environment files
-node_modules
+.env
+.env.*
+!.env.example
 
-# Build generated files
+# Visual Studio and IDE files
-dist
+.vs/
-lib
+.idea/
-solution
-temp
-*.sppkg
-
-# Coverage directory used by tools like istanbul
-coverage
-
-# OSX
-.DS_Store
-
-# Visual Studio files
 .ntvs_analysis.dat
-.vs
+*.suo
-bin
+*.user
-obj
+bin/
+obj/
 
-# Resx Generated Code
+# Operating system files
-*.resx.ts
+.DS_Store
+Thumbs.db
+Desktop.ini
 
-# Styles Generated Code
-*.scss.ts

README.md

@@ -1,26 +1,43 @@
-## custom-branding
+# Custom Branding
 
-This is where you include your WebPart documentation.
+Custom Branding ist ein SPFx-1.4.1-Application-Customizer fuer SharePoint Server Subscription Edition. Die Solution laedt zentral konfigurierte Stylesheets und kann strukturierte Inhalte in den oberen und unteren SharePoint-Placeholder rendern.
 
-### Building the code
+## Version
 
-```bash
+`1.0.4.0`
-git clone the repo
+
-npm i
+## Konfiguration
-npm i -g gulp
+
-gulp
+Die Konfiguration wird in den `ClientSideComponentProperties` der aktiven UserCustomAction gespeichert und zentral ueber PortalSettings gepflegt:
+
+```json
+{
+  "cssfiles": [],
+  "placeholdertop": {
+    "elements": []
+  },
+  "placeholderbottom": {
+    "elements": []
+  }
+}
 ```
 
-This package produces the following:
+## Build
 
-* lib/* - intermediate-stage commonjs build artifacts
+Die Legacy-SPFx-Toolchain benoetigt Node.js 8.17.0:
-* dist/* - the bundled script, along with other resources
-* deploy/* - all resources which should be uploaded to a CDN.
 
-### Build options
+```powershell
+npm install
+npm run package
+```
 
-gulp clean - TODO
+Das Paket wird unter `sharepoint/solution/custom-branding.sppkg` erzeugt.
-gulp test - TODO
+
-gulp serve - TODO
+## Installation
-gulp bundle - TODO
+
-gulp package-solution - TODO
+1. `custom-branding.sppkg` in den App Catalog laden beziehungsweise ersetzen.
+2. Die App im Root Web der Site Collection installieren oder aktualisieren.
+3. Beim Aktivieren wird der Custom Branding Application Customizer automatisch web-scoped registriert.
+4. PortalSettings mit `Strg+F5` neu laden und den Tab **Custom Branding** konfigurieren.
+
+Das Skript `deployment/add-custombranding.ps1` bleibt fuer automatisierte Rollouts oder eine ausdruecklich site-scoped Registrierung verfuegbar.

config/package-solution.json

@@ -3,9 +3,22 @@
   "solution": {
     "name": "custom-branding-client-side-solution",
     "id": "03a7c4de-e031-4b83-a683-5ca5c364166e",
-    "version": "1.0.3.0",
+    "version": "1.0.4.0",
     "includeClientSideAssets": true,
-    "skipFeatureDeployment": true
+    "skipFeatureDeployment": false,
+    "features": [
+      {
+        "title": "Custom Branding extension registration",
+        "description": "Registers the Custom Branding Application Customizer in the host web.",
+        "id": "2eb6deaa-a4a0-40c5-9f15-6bdaff36094f",
+        "version": "1.0.4.0",
+        "assets": {
+          "elementManifests": [
+            "elements.xml"
+          ]
+        }
+      }
+    ]
   },
   "paths": {
     "zippedPackage": "solution/custom-branding.sppkg"

package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "custom-branding",
-  "version": "0.0.1",
+  "version": "1.0.4",
   "lockfileVersion": 1,
   "requires": true,
   "dependencies": {

package.json

@@ -1,6 +1,6 @@
 {
   "name": "custom-branding",
-  "version": "0.0.2",
+  "version": "1.0.4",
   "private": true,
   "main": "lib/index.js",
   "engines": {
@@ -9,7 +9,8 @@
   "scripts": {
     "build": "gulp bundle",
     "clean": "gulp clean",
-    "test": "gulp test"
+    "test": "gulp test",
+    "package": "gulp clean && gulp bundle --ship && gulp package-solution --ship"
   },
   "dependencies": {
     "@microsoft/sp-core-library": "~1.4.0",

sharepoint/assets/elements.xml

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="utf-8"?>
+<Elements xmlns="http://schemas.microsoft.com/sharepoint/">
+  <CustomAction
+    Title="Custom Branding Application Customizer"
+    Location="ClientSideExtension.ApplicationCustomizer"
+    ClientSideComponentId="035ba968-6488-4d42-86b3-0470ffcc95b9"
+    ClientSideComponentProperties="{&quot;cssfiles&quot;:[],&quot;placeholdertop&quot;:{&quot;elements&quot;:[]},&quot;placeholderbottom&quot;:{&quot;elements&quot;:[]}}" />
+</Elements>

src/extensions/customBranding/CustomBrandingApplicationCustomizer.ts

@@ -1,4 +1,7 @@
 import { override } from '@microsoft/decorators';
+// Legacy SPFx 1.4 implementation; incremental modernization is tracked separately.
+// tslint:disable:max-line-length no-consecutive-blank-lines no-function-expression no-trailing-whitespace typedef
+
 import { Log } from '@microsoft/sp-core-library';
 import {
   BaseApplicationCustomizer,
@@ -6,8 +9,6 @@ import {
   PlaceholderName
 } from '@microsoft/sp-application-base';
 
-import * as strings from 'CustomBrandingApplicationCustomizerStrings';
-
 const LOG_SOURCE: string = 'CustomBrandingApplicationCustomizer';
 
 /**

src/extensions/customBranding/loc/myStrings.d.ts

@@ -4,5 +4,6 @@ declare interface ICustomBrandingApplicationCustomizerStrings {
 
 declare module 'CustomBrandingApplicationCustomizerStrings' {
   const strings: ICustomBrandingApplicationCustomizerStrings;
+  // tslint:disable-next-line:export-name
   export = strings;
 }