PHPackages                             haltuf/ecomail-nette - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. haltuf/ecomail-nette

ActiveLibrary[API Development](/categories/api)

haltuf/ecomail-nette
====================

Independent Ecomail API wrapper for Nette

v0.2(9mo ago)15.3k↓36.4%7BSD-3-ClausePHPPHP &gt;=7.4CI passing

Since Jan 27Pushed 9mo ago1 watchersCompare

[ Source](https://github.com/haltuf/ecomail-nette)[ Packagist](https://packagist.org/packages/haltuf/ecomail-nette)[ RSS](/packages/haltuf-ecomail-nette/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (2)Dependencies (6)Versions (3)Used By (0)

Ecomail API for Nette
=====================

[](#ecomail-api-for-nette)

Jednoduchá implementace Ecomail API pro Nette, pokrývá jen část rozsahu celého API. Za případné rozšíření budu rád, v současné chvíli jsem pro ostatní funkce neměl využití.

Autor nemá žádné spojení s firmou Ecomail ani s Nette Framework.

Požadavky
---------

[](#požadavky)

- PHP 7.4-8.4 a Nette 3 (v0.2)

Instalace
---------

[](#instalace)

Nejjednodušším způsobem instalace je přidat pomocí příkazu

```
composer require haltuf/ecomail-nette

```

Použtí
------

[](#použtí)

Do souboru `config.neon` přidejte následující řádky:

```
extensions:
	ecomail: Ecomail\Extension

ecomail:
	key: YOUR_KEY_HERE

```

Službu si injectněte do Presenteru:

```
	#[Inject]
	public Ecomail\Ecomail $ecomail;
```

případně pokud stále používáte PHP 7.4, tak:

```
	/** @inject */
	public Ecomail\Ecomail ecomail;
```

A následně můžete používat:

```
	// Seznamy kontaktů
	// ----------------
	// získá všechny seznamy kontaktů
	$this->ecomail->getLists();

	// získá konkrétní seznam kontaktů
	$this->ecomail->getList(1);

	// získá odběratele newsletteru, stránkování funguje po 20
	$this->ecomail->getSubscribers(1, $page);

	// získá konkrétního odběratele ze seznamu kontaktů ID 1
	$this->ecomail->getSubscriber(1, 'example@example.com');

	// vytvoří nového odběratele, pokud existuje, tak ho upraví
	// pro seznam všech možných hodnot se podívejte na kód funkce
	$this->ecomail->addSubscriber(1, array('email' => 'example@example.com'), false, true, true);

	// smazání odběratele
	$this->ecomail->deleteSubscriber(1, 'example@example.com');

	// aktualizace odběratele
	$this->ecomail->updateSubscriber(1, array('email' => 'example@example.com', 'name' => 'Nové jméno'));

	// Kampaně
	// -------
	// získá všechny kampaně
	$this->ecomail->getCampaigns();

	// získá konkrétní kampaň
	$this->ecomail->getCampaign('campaign_id');

	// vytvoří novou kampaň
	$this->ecomail->createCampaign(array('name' => 'Nová kampaň', 'subject' => 'Předmět', 'list_id' => 1));

	// aktualizuje existující kampaň
	$this->ecomail->updateCampaign('campaign_id', array('name' => 'Upravená kampaň'));

	// odešle kampaň
	$this->ecomail->sendCampaign('campaign_id');

	// Šablony
	// -------
	// získá konkrétní šablonu
	$this->ecomail->getTemplate('template_id');

	// vytvoří novou šablonu
	$this->ecomail->createTemplate(array('name' => 'Nová šablona', 'content' => '...'));

	// Automatizace (Pipelines)
	// -----------------------
	// získá všechny automatizace
	$this->ecomail->getPipelines();

	// získá konkrétní automatizaci
	$this->ecomail->getPipeline('pipeline_id');

	// spustí automatizaci pro konkrétní e-mail
	$this->ecomail->triggerPipeline('pipeline_id', 'example@example.com');

	// Domény
	// ------
	// získá všechny domény
	$this->ecomail->getDomains();

	// vytvoří novou doménu
	$this->ecomail->createDomain(array('domain' => 'example.com'));

	// smaže doménu
	$this->ecomail->deleteDomain('domain_id');

	// Transakční e-maily
	// -----------------
	// odešle transakční e-mail
	$this->ecomail->sendTransactionalMessage(array(
		'to' => 'recipient@example.com',
		'subject' => 'Předmět',
		'from_email' => 'sender@example.com',
		'from_name' => 'Odesílatel',
		'html' => 'Obsah e-mailu'
	));

	// odešle transakční e-mail pomocí šablony
	$this->ecomail->sendTransactionalTemplate(array(
		'to' => 'recipient@example.com',
		'template_id' => 'template_id',
		'from_email' => 'sender@example.com',
		'from_name' => 'Odesílatel',
		'variables' => array('var1' => 'hodnota1')
	));

	// Transakce
	// ---------
	// vytvoří novou transakci
	$this->ecomail->createTransaction(
		array('email' => 'customer@example.com', 'order_id' => '123', 'amount' => 1000),
		array(array('code' => 'PROD1', 'title' => 'Produkt 1', 'price' => 1000, 'quantity' => 1))
	);

	// aktualizuje existující transakci
	$this->ecomail->updateTransaction(
		'123',
		array('email' => 'customer@example.com', 'amount' => 1500),
		array(array('code' => 'PROD1', 'title' => 'Produkt 1', 'price' => 1500, 'quantity' => 1))
	);

	// smaže transakci
	$this->ecomail->deleteTransaction('123');

	// Globální operace s odběrateli
	// ----------------------------
	// získá informace o odběrateli napříč všemi seznamy
	$this->ecomail->getGlobalSubscriber('example@example.com');

	// smaže odběratele ze všech seznamů
	$this->ecomail->deleteGlobalSubscriber('example@example.com');

	// Vyhledávání
	// ----------
	// vyhledá odběratele podle e-mailu
	$this->ecomail->search('example@example.com');

	// Webhook
	// -------
	// nastaví webhook URL
	$this->ecomail->setWebhook('https://example.com/webhook');

	// získá aktuální webhook URL
	$this->ecomail->getWebhook();

	// smaže webhook URL
	$this->ecomail->deleteWebhook();
```

###  Health Score

40

—

FairBetter than 88% of packages

Maintenance56

Moderate activity, may be stable

Popularity27

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity54

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~3106 days

Total

2

Last Release

292d ago

PHP version history (2 changes)v0.1PHP &gt;=5.3.1

v0.2PHP &gt;=7.4

### Community

Maintainers

![](https://www.gravatar.com/avatar/e01053ba7aad458d64551f8bb00db83276040efbe4ebbdd05d8f2f2c85b0467b?d=identicon)[haltuf](/maintainers/haltuf)

---

Top Contributors

[![haltuf](https://avatars.githubusercontent.com/u/325759?v=4)](https://github.com/haltuf "haltuf (9 commits)")

---

Tags

apinetteEcomail

### Embed Badge

![Health badge](/badges/haltuf-ecomail-nette/health.svg)

```
[![Health](https://phpackages.com/badges/haltuf-ecomail-nette/health.svg)](https://phpackages.com/packages/haltuf-ecomail-nette)
```

###  Alternatives

[apigen/apigen

PHP source code API generator.

2.2k627.9k225](/packages/apigen-apigen)[tomaj/nette-api

Nette api

36261.8k4](/packages/tomaj-nette-api)[contributte/comgate

Comgate Payment Gateway for Nette Framework

19839.7k1](/packages/contributte-comgate)[kelemen/api-nette

Api for Nette framework

181.9k](/packages/kelemen-api-nette)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
