https://github.com/soderlind/ai-provider-for-azure-ai-foundry
Connect WordPress 7.0+ to Azure AI Foundry for text generation, image generation, embeddings, and more.
https://github.com/soderlind/ai-provider-for-azure-ai-foundry
wordpress-ai-provider wordpress-connector
Last synced: 24 days ago
JSON representation
Connect WordPress 7.0+ to Azure AI Foundry for text generation, image generation, embeddings, and more.
- Host: GitHub
- URL: https://github.com/soderlind/ai-provider-for-azure-ai-foundry
- Owner: soderlind
- Created: 2026-03-30T10:30:37.000Z (2 months ago)
- Default Branch: main
- Last Pushed: 2026-04-05T14:27:24.000Z (about 2 months ago)
- Last Synced: 2026-04-05T16:14:14.991Z (about 2 months ago)
- Topics: wordpress-ai-provider, wordpress-connector
- Language: PHP
- Homepage:
- Size: 714 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
Awesome Lists containing this project
README
# AI Provider for Azure AI Foundry
Connect WordPress 7.0+ to [Azure AI Foundry](https://learn.microsoft.com/en-us/rest/api/aifoundry/modelinference/) for text generation, image generation, embeddings, and more.
Works with WordPress 7 RC3. Tested using WordPress [AI](https://wordpress.org/plugins/ai/) (regenerate title, regenerate summary and generate new feature image). Text to speech tested using the [Talking Head](https://github.com/soderlind/talking-head) plugin.
## Features
- **AI Client integration** — registers as a WordPress 7.0 AI provider, usable via `wp_ai_client_prompt()` and Settings → Connectors.
- **OpenAI-compatible** — uses the Azure AI Foundry `/chat/completions` endpoint which follows the OpenAI chat format.
- **Capability detection** — auto-detects deployed models and capabilities (text generation, chat history, image generation, embeddings, text-to-speech) by probing the Azure endpoint.
- **Multiple endpoint types** — supports Azure AI Services (`.services.ai.azure.com`), Azure OpenAI (`.openai.azure.com`), and Cognitive Services (`.cognitiveservices.azure.com`).
- **Auto-detection** — discovers all deployed models via POST-based probing. No manual model name or API version configuration needed.
- **Custom authentication** — sends the `api-key` header required by Azure (instead of `Authorization: Bearer`).
- **Endpoint validation** — validates Azure endpoint URLs and shows inline errors for invalid URLs.
- **Environment variable fallback** — every setting can be overridden via environment variables or `wp-config.php` constants.
- **Connectors page UI** — custom React-based connector on the Settings → Connectors page with fields for API key and endpoint URL. Detected deployments and capabilities displayed as read-only chips.
## Documentation
- [How to Build an AI Provider Plugin for WordPress 7](docs/how-to-add-ai-provider.md) — deep-dive into provider registration, settings, authentication, and the Connectors page UI.
## Requirements
- WordPress 7.0 or later
- PHP 8.3+
- An [Azure AI Foundry](https://ai.azure.com/) resource with a deployed model
## Installation
### From GitHub
1. Download [`ai-provider-for-azure-ai-foundry.zip`](https://github.com/soderlind/azure-ai-foundry/releases/latest/download/ai-provider-for-azure-ai-foundry.zip)
2. Upload via `Plugins → Add New → Upload Plugin`
3. Activate via `WordPress Admin → Plugins`
### From [WordPress.org](https://wordpress.org/plugins/ai-provider-for-azure-ai-foundry/)
1. Go to **Plugins > Add New**
2. Search for "AI Provider for Azure AI Foundry"
3. Click **Install Now** and **Activate**
Then:
4. Go to **Settings → Connectors** and configure the Azure AI Foundry connector:
- **API Key** — your Azure AI Foundry API key.
- **Endpoint URL** — e.g. `https://my-resource.services.ai.azure.com/api/projects/PROJECT-NAME`.
5. Click **Connect & Detect** — the plugin probes your endpoint, discovers deployed models, and saves the configuration automatically.
## Configuration via Environment Variables
Settings can also be provided via environment variables or constants in `wp-config.php`:
| Setting | Environment Variable | wp-config.php Constant |
|--------------|-----------------------------------|-----------------------------------|
| API Key | `AZURE_AI_FOUNDRY_API_KEY` | `AZURE_AI_FOUNDRY_API_KEY` |
| Endpoint | `AZURE_AI_FOUNDRY_ENDPOINT` | `AZURE_AI_FOUNDRY_ENDPOINT` |
| Model Names | `AZURE_AI_FOUNDRY_MODEL` | `AZURE_AI_FOUNDRY_MODEL` |
| Capabilities | `AZURE_AI_FOUNDRY_CAPABILITIES` | `AZURE_AI_FOUNDRY_CAPABILITIES` |
Model names and capabilities are normally auto-detected. Use these overrides only when you need to pin specific values. Model names accept comma-separated deployment names, e.g. `gpt-4.1,gpt-image-1`. Capabilities accept a comma-separated string, e.g. `text_generation,chat_history,image_generation`.
## Usage
Once configured, the provider is available to any code using the WordPress AI Client:
```php
// Text generation
$text = wp_ai_client_prompt( 'Explain gravity in one sentence.' )->generate_text();
echo $text;
// Image generation
$image = wp_ai_client_prompt( 'A tiny blue cat on a cloud' )->generate_image();
// Text-to-speech
$audio = wp_ai_client_prompt( 'Hello world' )->convert_text_to_speech();
```
## Development
### Build
```bash
npm install
npm run build # Production build
npm run start # Watch mode
```
### Test
```bash
npm run test # Run Vitest tests
npm run test:watch # Interactive watch mode
```
### Plugin Structure
```
azure-ai-foundry/
├── ai-provider-for-azure-ai-foundry.php ← Main plugin file
├── src/
│ ├── autoload.php ← PSR-4 autoloader
│ ├── Provider/ ← AI Client provider
│ ├── Models/ ← Text, image, embedding & TTS models
│ ├── Metadata/ ← Model metadata & capabilities
│ ├── Http/ ← api-key authentication
│ ├── Rest/ ← REST API (capability detection)
│ ├── Settings/ ← Connector settings + manager
│ └── js/connectors.js ← Connectors page UI (source)
├── build/connectors.js ← Compiled ESM module
├── tests/js/ ← Vitest tests
├── webpack.config.js ← ESM output config
└── vitest.config.js ← Test config
```
## License
GPL-2.0-or-later