---
title: 'The Joomla Manifest File'
url: 'https://manuals.remository.com/payage-dev/adding-a-new-gateway/the-joomla-manifest-file'
markdown: 'https://manuals.remository.com/payage-dev/adding-a-new-gateway/the-joomla-manifest-file.md'
date: '2026-11-14'
description: 'Payage addons install as extension type "file". <?xml version="1.0" encoding="utf-8"?> <extension type="file" version="3.0.0" method="upgrade"> <name>Payage_PayPal</name> <creationDate></creationDate> <author>Les Arbres Design, Martin Brampton</author&gt…'
taxonomy:
  category:
    - docs
---

[](#) [ edit this page](https://github.com/getgrav/grav-skeleton-rtfm-site/blob/develop/pages/05.adding-a-new-gateway/04.the-joomla-manifest-file/docs.md) 

# The Joomla Manifest File

Payage addons install as extension type "file".

```
<?xml version="1.0" encoding="utf-8"?>
<extension type="file" version="3.0.0" method="upgrade">
<name>Payage_PayPal</name>
<creationDate></creationDate>
<author>Les Arbres Design, Martin Brampton</author>
<copyright>Les Arbres Design 2014-2023, Martin Brampton 2026</copyright>
<license>GNU/GPL</license>
<authorUrl>https://remository.com</authorUrl>
<version>1.00</version>
<description>PayPal Gateway for Payage</description>
```

We add some additional information to the install manifest, which is ignored by the Joomla installer, but used by Payage:

```
<gateway_info>
    <type>PayPal_Standard</type>
    <modelClass>PayPalGatewayModel</modelClass>
    <shortName>PayPal Standard</shortName>
    <longName>PayPal Payments Standard</longName>
    <defaultButton>images/pay_buttons/paypal_ft200.png</defaultButton>
    <defaultTitle>Pay with PayPal</defaultTitle>
    <defaultButtonText>Pay with</defaultButtonText>
    <defaultButtonIcon2>paypal.png</defaultButtonIcon2>
    <defaultButtonClass>pg-colour-yellow</defaultButtonClass>
    <gatewayUrl>https://www.paypal.com/</gatewayUrl>
    <helpUrl>https://remository.com/support/support-tickets</helpUrl>
    <docUrl>https://remository.com/downloads/07_-Public-Files/Payage-User-Guide</docUrl>
</gateway_info>
```

| Element | Description |
|---|---|
| type | This must be unique, less than 32 characters and include one underscore. It must not contain spaces. |
| shortName | The shortest possible description of the gateway, up to 32 characters. |
| longName | A longer and more precise description of the gateway, up to 80 characters. |
| defaultButton | The default image for image buttons for new accounts of this type. |
| defaultTitle | The default title text for image buttons. |
| defaultButtonText | The default button text for responsive buttons. |
| defaultButtonIcon1 | The default left icon for responsive buttons. |
| defaultButtonIcon2 | The default right icon for responsive buttons. |
| defaultButtonClass | The default class for responsive buttons. |
| gatewayUrl | The URL of the gateway's home page. |
| helpUrl | The URL that users should go to if they have a problem with the addon. This must be on the author's site, not Remository. |
| docUrl | The URL where users can obtain documentation for the addon. This must be on the author's site, not Remository. |

The files to be installed are controlled by the  entries:

```
<fileset>
    <files target="administrator/components/com_payage">
        <filename>payage_paypal_standard.xml</filename>
    </files>

    <files target="images">
        <folder>pay_buttons</folder>
    </files>

    <files target="media/com_payage">
        <folder>icons</folder>
    </files>

    <files folder="Model" target="administrator/components/com_payage/src/Model">
        <filename>PayPalGatewayModel.php</filename>
    </files>

    <files folder="form" target="administrator/components/com_payage/forms">
        <filename>paypal_standard.xml</filename>
    </files>

    <files folder="language/en-GB" target="administrator/components/com_payage/language/en-GB">
        <filename>payage_paypal_standard.ini</filename>
    </files>
</fileset>
```

 [ ](https://manuals.remository.com/payage-dev/adding-a-new-gateway/files-required) [](https://manuals.remository.com/payage-dev/adding-a-new-gateway/the-model)

---

## Navigation

- Parent: [Adding a New Gateway](https://manuals.remository.com/payage-dev/adding-a-new-gateway.md)
- Previous: [Files Required](https://manuals.remository.com/payage-dev/adding-a-new-gateway/files-required.md)
- Next: [The Model](https://manuals.remository.com/payage-dev/adding-a-new-gateway/the-model.md)