Skip to content

Preferences subdomain

Yoann Gini edited this page Apr 21, 2020 · 9 revisions

Introduced in Hello IT 1.2.9

Concept

Main preferences are located in com.github.ygini.Hello-IT domain as already described in this wiki.

Additional subdomains can be added as desired but only as a file in the user's preferences. Such a file must be named com.github.ygini.Hello-IT.YOURID.plist.

The main goal is to allow you to test some new content for Hello-IT and still have your computer managed as everyone else on the company.

Usage

As of HelloIT 1.4, you must specify allowSubdomains in your root preferences for sub-domains to work.

Subdomains are sorted in the alphabetical order and loaded at the top of the main Hello IT menu.

You can name the subdomain whatever you want. Here is some example:

  • com.github.ygini.Hello-IT.TestMenuForVIP
  • com.github.ygini.Hello-IT.TestMenuForPublicDevices

Root preference object MUST be a dictionary describing a unique function to load.

It can be a simple item:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
	<key>functionIdentifier</key>
	<string>public.script.item</string>
	<key>settings</key>
	<dict>
		<key>script</key>
		<string>com.github.ygini.hello-it.controlstrip.presenter.sh</string>
	</dict>
</dict>
</plist>

Or a submenu as the general preference file.

It's up to you.

Limitations

At this time, subdomains are supported only if loaded for the user (~/Library/Preferences), for technical reasons, we aren't able to make it work at the computer level or via MDM.