Skip to content
Jeremy D edited this page Mar 29, 2023 · 1 revision

File/Archive

DevTools supports compressing your customization into a zip and/or tgz (tar with gz compression) file formats. This uses the PharDar library in PHP. PharData is enabled by default in PHP and works with phar.readonly enabled (as we do not intend to make it executable).

xml node

Support has been added to add a node to the package-info.xml, which provides some assistance for the compression to build the archive properly.

packagename

Adding a <packagename> to the <devtools> node lets you define how the package will be named. There is support for replacements. An example of a package name may be <packagename>{CUSTOMIZATION_NAME}-{VERSION_}</packagename>. Do not include the extension, this is appended automatically.

exclusion

Adding a <exclusion> to the <devtools> node lets you define files to exclude. You can either include the full name, such as <exclusion>.git</exclusion> You can also use wildcards such as <exclusion>.*.yml</exclusion>.

Additional packagename replacements

Giving the following data:

	<name>My Customization</name>
	<version>1.2.3</version>

The following conversions will occur:

Original Replacement
{VERSION} 1.2.3
{VERSION-} 1-2-3
{VERSION_} 1_2_3
{CUSTOMIZATION-NAME} My-Customization
{CUSTOMIZATION_NAME} My_Customization
{CUSTOMIZATION NAME} My Customization
Clone this wiki locally