# Teanary Extensions 扩展模板仓库

**Repository Path**: teanary/teanary_extensions

## Basic Information

- **Project Name**: Teanary Extensions 扩展模板仓库
- **Description**: Teanary Service的扩展开发模板及文档，如有需要对接其它的支付方式/物流方式，可以按模板代码修改。
- **Primary Language**: PHP
- **License**: GPL-3.0
- **Default Branch**: main
- **Homepage**: https://teanary.com/zh_CN/index.html
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 1
- **Created**: 2026-01-17
- **Last Updated**: 2026-01-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Teanary Extensions 扩展模板仓库

这是 Teanary Service 的扩展模板仓库，用于创建和分发支付方式和运输方式的扩展。

## 📚 文档

- [扩展开发指南](./EXTENSION_GUIDE.md) - 完整的扩展开发文档

## 🎯 使用方式

### 方式一：基于模板创建新扩展

1. **复制模板文件**
   ```bash
   # 复制支付扩展模板
   cp -r templates/payment/your-extension-name my-extension
   
   # 或复制运输扩展模板
   cp -r templates/shipping/your-extension-name my-extension
   ```

2. **修改模板代码**
   - 替换所有 `YourExtension` 为你的扩展名称
   - 实现具体的业务逻辑
   - 更新配置和翻译文件

3. **集成到主项目**
   - 按照模板中的 `INTEGRATION.md` 步骤集成
   - 或参考 [扩展开发指南](./EXTENSION_GUIDE.md)

### 方式二：直接在主项目中开发

参考 [扩展开发指南](./EXTENSION_GUIDE.md) 中的详细步骤。

## 📁 目录结构

```
teanary-extensions/
├── README.md                    # 本文件
├── EXTENSION_GUIDE.md           # 扩展开发指南
├── templates/                   # 扩展模板
│   ├── payment/                 # 支付扩展模板
│   │   └── stripe/              # Stripe 支付模板示例
│   │       ├── README.md
│   │       ├── INTEGRATION.md
│   │       ├── src/
│   │       ├── config/
│   │       └── lang/
│   └── shipping/                # 运输扩展模板
│       └── dhl/                 # DHL 运输模板示例
│           ├── README.md
│           ├── INTEGRATION.md
│           ├── src/
│           ├── config/
│           └── lang/
└── examples/                    # 完整示例（可选）
    ├── stripe-payment/          # Stripe 支付完整示例
    └── dhl-shipping/           # DHL 运输完整示例
```

## 🚀 快速开始

### 创建支付扩展

1. 查看支付模板：`templates/payment/stripe/`
2. 复制并重命名模板
3. 实现支付网关接口
4. 按照集成指南集成到主项目

### 创建运输扩展

1. 查看运输模板：`templates/shipping/dhl/`
2. 复制并重命名模板
3. 实现运输计算器接口
4. 按照集成指南集成到主项目

## 📝 扩展命名规范

- **支付扩展**：`teanary-extension-{payment-name}`
  - 例如：`teanary-extension-stripe`、`teanary-extension-alipay`

- **运输扩展**：`teanary-extension-{shipping-name}`
  - 例如：`teanary-extension-dhl`、`teanary-extension-fedex`

## 🤝 贡献扩展

如果你开发了新的扩展，欢迎：

1. 创建独立的仓库（如 `teanary-extension-stripe`）
2. 基于本模板仓库的结构组织代码
3. 提供清晰的 README 和集成文档
4. 提交到 Gitee/Github 并告知我们

## 📞 获取帮助

- 📧 邮箱：hello@teanary.com
- 📱 电话：+86 18184839903
- 📖 文档：[扩展开发指南](./EXTENSION_GUIDE.md)

## 📄 许可证

本项目采用 [GNU General Public License v3.0](./LICENSE) (GPLv3) 许可证。

---

**Teanary Extensions** - 让扩展开发更简单 🎉