Make EzyPlatform Your Own
Updated at 1789744070000EzyPlatform can be customized to use your own plugin marketplaces, logo, copyright notice, and contact page. Once configured, the administration interface retains all EzyPlatform features while adopting your organization's branding and module distribution ecosystem.
Configure marketplaces
EzyPlatform supports a primary marketplace and multiple additional marketplaces through two properties in the admin
config.properties file:market.url=https://market.example.com market.urls=https://market-partner-a.example.com,https://market-partner-b.example.com
Where:
-
market.urlis your primary marketplace. When specified, this URL appears first in the marketplace list. -
market.urlsis a comma-separated list of additional marketplaces. - Whitespace and trailing
/characters are normalized automatically. - Duplicate URLs appear only once.
- The official marketplace at
https://ezyplatform.comis always appended to the list if it is not already present.
If you only want to add secondary marketplaces without defining your own primary marketplace, leave
market.url empty:
market.url= market.urls=https://market-a.example.com,https://market-b.example.com
Restart the admin service after changing these properties so the marketplace list is reloaded.
> Only add marketplaces that you trust. EzyPlatform treats the configured list as an allowlist. A URL submitted by the browser that is not in this list will not be used, and the system will fall back to the official marketplace.
How EzyPlatform works with multiple marketplaces
When a module screen needs to find a plugin or check its version, the admin service queries the configured marketplaces in order. The result retains the marketplace that supplied each module, ensuring that subsequent actions—such as viewing details, loading images, purchasing, or installing—continue to use the correct source marketplace.
flowchart TD
A[Administrator opens the module list] --> B[Admin loads the configured marketplace list]
B --> C[Organization's primary marketplace]
B --> D[Partner marketplace A]
B --> E[Partner marketplace B]
B --> F[Official EzyPlatform marketplace]
C --> G[Aggregate modules and retain their source marketplaces]
D --> G
E --> G
F --> G
G --> H{Administrator selects a module}
H --> I[Load details and images from the correct source]
H --> J[Purchase or install from the correct source]
J --> K[Check versions and dependencies]
K --> L[Install the module on EzyPlatform]
The declaration order matters:
market.url takes precedence, followed by the addresses in market.urls, and finally the official marketplace. Therefore, place your internal or branded marketplace first.Change the logo, copyright notice, and contact URL
The most convenient approach is to open the Settings page in the admin interface and create the following three
TEXT settings:| Setting name | Example value | Display location |
|---|---|---|
admin_ezyplatform_log_url | https://cdn.example.com/brand/logo.png | Logo in the admin sidebar |
admin_ezyplatform_copyright | Copyright © 2026 <a href="https://example.com">Example Corp</a>. | Admin footer |
admin_ezyplatform_contact_url | https://example.com/contact | Contact link in the navigation bar |
The name
admin_ezyplatform_log_url matches the key used by the current EzyPlatform version. Enter log_url exactly as shown. Changing it to logo_url will prevent the interface from finding the value.The copyright value is rendered as HTML, so it can contain links or simple formatting. Only allow trusted administrators to edit this setting, and never insert scripts or HTML supplied by users.
The logo can use an absolute CDN URL or a resource path accessible to the admin interface. A square or nearly square image with a transparent background is recommended so that it displays clearly in the sidebar.
Configure branding through the configuration file
You can also define default values in the admin
config.properties file:ezyplatform.logo_url=https://cdn.example.com/brand/logo.png ezyplatform.copyright=Copyright © 2026 Example Corp. ezyplatform.contact_url=https://example.com/contact
The properties in this file act as defaults. If the corresponding setting already exists in the database, the value from Settings takes precedence. This mechanism is useful when you want to:
- package default branding for new deployments;
- manage baseline configuration through deployment tools;
- allow each installation to customize its branding later through the Settings interface.
Restart the admin service after modifying the configuration file. When changing values directly through Settings, reload the page to verify the result.
Fallback values
When no custom branding values are configured, the admin interface uses the defaults:
- the default EzyPlatform logo;
- the Young Monkeys copyright notice;
- a contact link pointing to EzyPlatform's `/contact-us` page.
To restore the default interface, remove the custom settings and delete the corresponding properties from the configuration file.
Branding checklist
- Configure
market.urlfor your organization's primary marketplace. - Add partner marketplaces to
market.urlsin the intended priority order. - Use HTTPS for every marketplace and branding resource in production.
- Create
admin_ezyplatform_log_url,admin_ezyplatform_copyright, andadmin_ezyplatform_contact_urlin Settings. - Restart the admin service after changing
config.properties. - Verify the logo, footer, Contact link, and the module discovery and installation flow for every marketplace.
With these settings in place, you can run EzyPlatform under your own brand, prioritize your module repository, and retain access to the official EzyPlatform ecosystem.