## 💬 Support & Community on Telegram
Join the [Medusa Telegram community chat](https://t.me/medusajs_com) to discuss features, get support, and connect with developers building on Medusa.
## Prerequisites
- Medusa server v2.8.3 or later
- Node.js v20 or later
## Installation
```bash
yarn add @gorgo/medusa-feed-yandex
# or
npm install @gorgo/medusa-feed-yandex
```
## Configuration
Add the provider configuration in your `medusa-config.js` file of the Medusa admin application:
```ts
# ...
module.exports = defineConfig({
# ...
modules: [
{
resolve: "@gorgo/medusa-feed-yandex/modules/feed",
},
{
resolve: "@medusajs/medusa/file",
options: {
providers: [
{
resolve: "@medusajs/medusa/file-local",
id: "local",
options: {
upload_dir: "static",
backend_url: "http://localhost:9000/static"
},
},
],
},
},
],
plugins: [
{
resolve: "@gorgo/medusa-feed-yandex",
options: {}
}
],
})
```
> The plugin is currently tested with Medusa’s local file module (`file-local`) and saves the generated XML feeds to the local static directory.
## Usage
Open the Medusa Admin dashboard and navigate to **Settings** -> **Feeds** section in the Extensions — this is where the plugin interface is available.
The page displays all existing feeds with their key information.
Feed URLs follow this format, allowing direct access to the generated XML files (in YML format):
```
http://{YOUR_MEDUSA_DOMAIN}/feeds/{ID}/{FILE_NAME}.xml
```
Selecting a feed opens a detailed view where you can edit metadata, adjust export schedules, choose product categories, and access the feed URL. A **Launch now** button lets you manually trigger feed generation.
The feed shown in the screenshot above exports all product from all categories every 30 minutes to a file named `example1.xml`. It sets `Example shop name`, `Example company name`, `https://www.example.com/`, and `Medusa` as values for the corresponding XML properties. It is accessible via the link `http://localhost:9000/feeds/01JWTC5VDW8EAGHWRDQG2GKAQJ/example1.xml`, while the actual file is stored in gzip-compressed format at `http://localhost:9000/static/1748937061705-example1.xml.gz`.
Below is an example of a generated YML-file:
```xml
Example shop nameExample company namehttps://www.example.com/MedusaMedusa T-Shirtpcat_01JWBFYPTZNKZT0BRWECQF84J9https://medusa-public-images.s3.eu-west-1.amazonaws.com/tee-black-front.png400Medusa Sweatshirtpcat_01JWBFYPV0KQV6VY4HKW4W6JTNhttps://medusa-public-images.s3.eu-west-1.amazonaws.com/sweatshirt-vintage-front.png400Medusa Sweatpantspcat_01JWBFYPV16CG0MN8TF1EM4T4Nhttps://medusa-public-images.s3.eu-west-1.amazonaws.com/sweatpants-gray-front.png400Medusa Shortspcat_01JWBFYPV1CTZAK4JBKV0R2JZWhttps://medusa-public-images.s3.eu-west-1.amazonaws.com/shorts-vintage-front.png400
```
## Testing
You can run two types of tests for this plugin:
### Module Tests
These verify the internal logic, such as services and models.
```bash
yarn test:integration:modules
```
### Integration Tests
Integration tests include tests for API Routes and Workflows
```bash
yarn test:integration:http
```
Before running the tests, make sure your `.env.test` file includes the following variables: `DB_USERNAME`, `DB_PASSWORD`, `DB_HOST`, `DB_TEMP_NAME`.
## License
Licensed under the [MIT License](LICENSE).
