For the complete documentation index, see llms.txt. This page is also available as Markdown.

Extension Plugins

Select third-party adapters according to application scenarios, and understand the relationship between public contracts, plugin deployment, and external operating environments.

Different external capabilities are connected to the framework through adaptation interfaces

External extensions integrate third-party runtimes, infrastructure or cloud services with Zongsoft. The business module relies on the framework contract as much as possible, and the application composition layer is responsible for selecting the provider; the actual protocol, resources and fault behavior are still determined by the specific implementation.

Read on Demand

demand
Expand
Topics

Cache, serial number, distributed lock, in-process cache server

Redis、etcd、Garnet

Rule calculations, language scripts, text expressions

Lua、Python、Scriban

Background jobs, retries, timeouts and circuit breaking

Hangfire、Polly

Workbook exchange, template and cell operations

ClosedXml、OpenXml

Object storage, SMS push, WeChat and callback

Amazon、Aliyun、Wechat

Industrial communication and equipment data integration

Opc

Browse by Project

If the project name has been determined, you can enter the independent pages of 14 projects including Aliyun, Amazon, Redis, etcd, and Hangfire from Project index to view packages, configuration entries, and implementation restrictions.

Common Path of Integration

First determine the required public capabilities, and then deploy the implementation package and its accompanying files. After the plugin is loaded, check the configuration, service registration or plugin tree node, and finally perform a controlled call. Just seeing the name in the plugin list does not prove that the lazy link, native library, or third-party dependency version is correct.

This content should be merged into the existing host's deployment manifest. See Deployment Tool for deployment parameters and runtime directory; see The first business plugin for how to enable business plugins through configuration selection.

Three Common Integration Forms

service providersupplies cache, lock and other instances by connection name;Matchable servicesfinds evaluators and archivers by name or format;plugin tree builtin mounts the file system, worker and handler collections through extended paths. They are both plugin extensions, but they are obtained in different ways.

Don't see a type in the package and infer that it must be registered in the container; don't apply Redis's alias rules to other providers. See Service Resolution and Ownership for detailed differences.

Run and Version Boundaries

External service addresses, credentials, databases, buckets, certificates, and licenses are provided by the deployment environment. Package versions should be checked against a combination of host and third-party dependencies, especially if multiple deployment manifests copy different versions of DLLs to the same directory.

The framework adapter does not automatically create all cloud resources or override their permission configuration. The script plugin does not automatically become a security sandbox, and the Dashboard does not automatically become a complete operation and maintenance authority system. Each topic describes the capabilities that have been achieved, the responsibilities that need to be applied and the verification path.

Source references: external extension directory.

Last updated