{"id":19398034,"url":"https://github.com/piedweb/tinymaillistbuilder","last_synced_at":"2026-05-12T20:32:20.436Z","repository":{"id":57041421,"uuid":"174555699","full_name":"PiedWeb/TinyMailListBuilder","owner":"PiedWeb","description":"Tiny Mail List Builder for almost hand-held newsletter","archived":false,"fork":false,"pushed_at":"2019-03-08T15:19:49.000Z","size":5,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-01-07T11:12:04.564Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/PiedWeb.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2019-03-08T14:52:31.000Z","updated_at":"2019-03-25T13:58:04.000Z","dependencies_parsed_at":"2022-08-23T23:31:11.984Z","dependency_job_id":null,"html_url":"https://github.com/PiedWeb/TinyMailListBuilder","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PiedWeb%2FTinyMailListBuilder","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PiedWeb%2FTinyMailListBuilder/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PiedWeb%2FTinyMailListBuilder/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PiedWeb%2FTinyMailListBuilder/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/PiedWeb","download_url":"https://codeload.github.com/PiedWeb/TinyMailListBuilder/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":240571029,"owners_count":19822412,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-10T11:04:43.562Z","updated_at":"2026-05-12T20:32:20.402Z","avatar_url":"https://github.com/PiedWeb.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\u003ca href=\"https://dev.piedweb.com\"\u003e\n\u003cimg src=\"https://raw.githubusercontent.com/PiedWeb/piedweb-devoluix-theme/master/src/img/logo_title.png\" width=\"200\" height=\"200\" alt=\"Open Source Package\" /\u003e\n\u003c/a\u003e\u003c/p\u003e\n\n# Tiny MailList Builder...\n\n... for almost hand-held newsletter.\n\n\n## Install\n\nUsing composer : [Packagist](https://packagist.org/packages/piedweb/tiny-maillist-builder)\n\n``` bash\n$ composer require piedweb/tiny-maillist-builder\n```\n\n## Usage\n\nThis example demonstrate the possible usage on a static website on the one hand (where we want\nthe user suscribe to our email list), and on the other hand, a dynamic server with a specific\nsubdomain (eg: mail-list.example.tld).\n\nThe dynamic server will host our package and a simple controller like :\n\n``` php\ninclude 'vendor/autoload.php';\n\nheader(\"Access-Control-Allow-Origin: *\");\n\nif ($_SERVER['REQUEST_METHOD'] === 'POST')\n{\n    $list = new TinyMailListBuilder(['piedweb'], 'list');\n    if ($list-\u003eadd(trim($_POST['email'] ?? ''), $_POST['list'] ?? '')) {\n        exit('OK');\n    } else {\n        exit('EVER');\n    }\n\n} else {\n    header(\"HTTP/1.1 401 Unauthorized\");\n    exit('ERROR');\n}\n\n```\n\nThe static website will integrate in his front end something like :\n``` javascript\nimport { tinyMailListBuilder } from \"~/vendor/piedweb/tiny-maillist-builder/js/TinyMailListBuilder.js\";\n\nvar form = document.getElementById(\"newsletter\");\nvar config_list = 'piedweb';\n\nform.addEventListener(\"submit\", function(evt) {\n    evt.preventDefault();\n  form.querySelector('input[type=\"submit\"]').value = '...';\n  form.querySelector('input[type=\"submit\"]').setAttribute('disabled', 'disabled');\n    tinyMailListBuilder(form, function(text) {console.log(text);form.querySelector('input[type=\"submit\"]').value = 'Stored !';});\n}, config_list);\n```\n``` html\n\u003cform action=\"https://mailist.example.tld/\" id=\"newsletter\"\u003e\n  \u003cinput type=email placeholder=\"contact@example.tld\"\u003e\n  \u003cinput type=submit \u003e\n\u003c/form\u003e\n```\n\n## Contributing\n\nPlease see [contributing](https://dev.piedweb.com/contributing)\n\n## Credits\n\n- [PiedWeb](https://piedweb.com)\n- [All Contributors](https://github.com/PiedWeb/:package_skake/graphs/contributors)\n\n## License\n\nThe MIT License (MIT). Please see [License File](LICENSE) for more information.\n\n[![Latest Version](https://img.shields.io/github/tag/PiedWeb/TinyMailListBuilder.svg?style=flat\u0026label=release)](https://github.com/PiedWeb/TinyMailListBuilder/tags)\n[![Software License](https://img.shields.io/badge/license-MIT-brightgreen.svg?style=flat)](LICENSE)\n[![Build Status](https://img.shields.io/travis/PiedWeb/TinyMailListBuilder/master.svg?style=flat)](https://travis-ci.org/PiedWeb/TinyMailListBuilder)\n[![Quality Score](https://img.shields.io/scrutinizer/g/PiedWeb/TinyMailListBuilder.svg?style=flat)](https://scrutinizer-ci.com/g/PiedWeb/TinyMailListBuilder)\n[![Code Coverage](https://img.shields.io/scrutinizer/coverage/g/PiedWeb/TinyMailListBuilder.svg?style=flat)](https://scrutinizer-ci.com/g/PiedWeb/TinyMailListBuilder/code-structure)\n[![Total Downloads](https://img.shields.io/packagist/dt/piedweb/tiny-maillist-builder.svg?style=flat)](https://packagist.org/packages/piedweb/tiny-maillist-builder)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpiedweb%2Ftinymaillistbuilder","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpiedweb%2Ftinymaillistbuilder","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpiedweb%2Ftinymaillistbuilder/lists"}