Adding Wiki page to this repo

[AndrewDemski-ad-gmail-com]

Hi guys,

After some observation I realized that users are still having problems because hey need to go through the readme alone + code samples for mods.
A wikipage would be a nice addition to WAU on github.
Everything would be centralized and self-contained.
Also main readme would stop being a rather tall stepping stone for new users.

Food for thoughts..

Cheers
AD

[KnifMelti]

Food for thoughts..

I agree!
I have just started my own Wiki and in that I plan to explain all the thoughts I had when implementing this feature, and also how it is used + examples.
I could copy and paste to WAU Wiki the how it is used/examples part?

[AndrewDemski-ad-gmail-com]

Hm.. such Wiki must be initiated first by @Romanitho, the Owner of this repository.

[Romanitho]

First page initiated 😅

[KnifMelti]

I don't know how to work with this, I can't push to it.

[KnifMelti]

This is my own summarizing of everything about mods on WAU pages:

Custom Script for WAU (_WAU-mods.ps1)

• Placed in mods folder and executes if network is active/any version of Winget is installed/WAU is running as SYSTEM
• If ExitCode is 1 from _WAU-mods.ps1 then Re-run WAU
• New action-based system is now supported that allows multiple actions and conditions directly in mod scripts for advanced automation and better control over the WAU process
• _WAU-mods-postsys.ps1 can be used for actions at the end of the SYSTEM context WAU process before user run
• Templates available: _WAU-mods-template.ps1 and _WAU-mods-postsys-template.ps1

App-specific Mods (AppID-based)

Scripts placed in mods folder with AppID followed by suffix:

Execution order:

• AppID-preinstall.ps1 - Runs before upgrade/install
• AppID-upgrade.ps1 or AppID-install.ps1 - Runs during upgrade/install (before install check)
• AppID-installed.ps1 - Runs after upgrade/install has been confirmed
• AppID-notinstalled.ps1 - Runs after a failed upgrade/install
• _WAU-notinstalled.ps1 - Global fallback for failed installations (overridden by individual AppID-notinstalled.ps1)
• Templates available: _AppID-template.ps1 and _WAU-notinstalled-template.ps1

Uninstall support (for use with Winget-Install):

• AppID-preuninstall.ps1, AppID-uninstall.ps1, AppID-uninstalled.ps1

Important notes:

• -install mod will be used for upgrades too if -upgrade doesn't exist
• AppID-install.ps1 is recommended because it's used in both scenarios
• If AppID-preinstall.ps1 or AppID-preuninstall.ps1 returns $false, the install/update/uninstall for that AppID is skipped

Winget Native Parameters

Override parameters:

• Text file: AppID-override.txt in mods folder
• Example: Adobe.Acrobat.Reader.64-bit-override.txt with content:

  "-sfx_nu /sAll /rs /msi EULA_ACCEPT=YES DISABLEDESKTOPSHORTCUT=1"
  

• Used as winget --override parameter

Custom parameters:

• Text file: AppID-custom.txt in mods folder
• Example: ShareX.ShareX-custom.txt with content:

  /MERGETASKS=!CreateDesktopIcon
  

• Used as winget --custom parameter (arguments in addition to defaults)