haxocz/ecomail-nette

Independent Ecomail API wrapper for Nette

1.0.1 2024-01-12 15:32 UTC

Requires

• php: ^7.4|>=8.1
• ext-curl: *
• nette/di: ^3.0

BSD-3-Clause

• Michal Haltuf
• Petr Balvín

• api
• nette
• Ecomail

README

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

• Nette 2.3 a vyšší (v0.1)
• PHP 8 a Nette 3 (dev-main)

Instalace

Nejjednodušším způsobem instalace je přidat do souboru composer.json:

	"require": {
		"haltuf/ecomail-nette": "dev-main"
	}

nebo pomocí příkazu

composer require haltuf/ecomail-nette:@dev

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:

	/** @var \Ecomail\Ecomail @inject */
	public $ecomail;

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

	// 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, '[e-mail]');

	// 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' => '[e-mail]', FALSE, TRUE, TRUE));

	// smazání odběratele
	$this->ecomail->deleteSubscriber(1, '[e-mail]');