{"id":25209637,"url":"https://github.com/backdrop-contrib/simplenews","last_synced_at":"2026-02-11T01:19:47.812Z","repository":{"id":29365453,"uuid":"32900066","full_name":"backdrop-contrib/simplenews","owner":"backdrop-contrib","description":"SimpleNews publishes and sends newsletters to lists of subscribers. Both anonymous and authenticated users can opt-in to different mailing lists. HTML email can be sent by adding Mime mail module.","archived":false,"fork":false,"pushed_at":"2026-01-30T05:29:54.000Z","size":1797,"stargazers_count":1,"open_issues_count":5,"forks_count":4,"subscribers_count":32,"default_branch":"1.x-1.x","last_synced_at":"2026-01-30T14:35:59.272Z","etag":null,"topics":["backdrop","backdropcms","newsletters","simplenews"],"latest_commit_sha":null,"homepage":"https://backdropcms.org/project/simplenews","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/backdrop-contrib.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2015-03-26T01:08:36.000Z","updated_at":"2026-01-30T05:29:58.000Z","dependencies_parsed_at":"2024-03-26T05:22:10.684Z","dependency_job_id":"5c266236-ab56-4ef7-9d83-278dd8b400c2","html_url":"https://github.com/backdrop-contrib/simplenews","commit_stats":null,"previous_names":[],"tags_count":14,"template":false,"template_full_name":null,"purl":"pkg:github/backdrop-contrib/simplenews","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/backdrop-contrib%2Fsimplenews","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/backdrop-contrib%2Fsimplenews/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/backdrop-contrib%2Fsimplenews/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/backdrop-contrib%2Fsimplenews/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/backdrop-contrib","download_url":"https://codeload.github.com/backdrop-contrib/simplenews/tar.gz/refs/heads/1.x-1.x","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/backdrop-contrib%2Fsimplenews/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29324007,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-11T00:34:26.354Z","status":"ssl_error","status_checked_at":"2026-02-11T00:34:09.494Z","response_time":65,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["backdrop","backdropcms","newsletters","simplenews"],"created_at":"2025-02-10T13:18:09.310Z","updated_at":"2026-02-11T01:19:47.792Z","avatar_url":"https://github.com/backdrop-contrib.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"\nDescription\n-----------\n\nSimpleNews publishes and sends newsletters to lists of subscribers. Both anonymous and authenticated users can opt-in to different mailing lists. HTML email can be sent by adding Mime mail module.\n\n\nRequirements\n------------\n\n * For large mailing lists, cron is required.\n * HTML-format newsletters and/or newsletters with file attachments require the mime mail or HTML mail module.\n * When sending newsletters on regular cron (cron.php), it is important that the base url (settings.php, variable $base_url) is set correctly or links inside the newsletter will not work.\n * Additionally, when using Drush to start cron, it is important to use the argument --uri=http://www.example.com\n\n\nInstallation\n------------\n\nYou can install the module through your Backdrop website's user interface per instructions on https://backdropcms.org/guide/modules or by simply running the `bee en simplenews` command on command line.\n\nConfiguration\n-------------\n\n\n* To administer various SimpleNews settings go to Configuration \u003e Web services \u003e Newsletter \u003e Settings  (`/admin/config/services/simplenews/settings`).\n\n* Add or edit newsletter categories on Configuration \u003e Web services \u003e Newsletter (`/admin/config/services/simplenews`).\n\n* By default, SimpleNews creates a new `SimpleNews newsletter` content type, however you can enable any other content type to use as a newsletter on Structure \u003e Content types \u003e content type \u003e Configure \u003e Publishing settings \u003e Use as SimpleNews newsletter.\n\n* To enable SimpleNews subscription blocks go to Structure \u003e Layouts and choose a layout. Most probably you want to place subscription blocks on Home page or Default layouts. Choose a layout region where you want to place a SimpleNews block, click on \"Add block\" and choose one of `Newsletter: your website newsletter` or `Newsletter: Multi Subscription`.\n\n\nUsage\n-----\n\n1. ENABLE SIMPLENEWS BLOCK\n\nWith the SimpleNews block users can subscribe to a newsletter. Enable a SimpleNews block per Newsletter category on Configuration \u003e Web services Newsletters page.\n\n2. SEND MAILING LISTS\n\nCron is required to send large mailing lists. If you have a medium or large size mailing list (i.e. more than 500 subscribers) always use cron to send the newsletters.\n\nTo use cron:\n  * Check the 'Use cron to send newsletters' checkbox.\n  * Set the 'Cron throttle' to the number of newsletters send per cron run. Too high values may lead to mail server overload or you may hit hosting restrictions.\n\nDon't use cron:\n  * Uncheck the 'Use cron to send newsletters' checkbox.\n\nAll newsletters will be sent immediately when saving the node. If not all emails can be sent within the available php execution time, the remainder will be sent by cron. Therefore, ALWAYS enable cron.\n\nThese settings are found on the Newsletter Settings page under 'Send mail' options at Administer \u003e Configuration \u003e Web Services \u003e Newsletters \u003e Settings \u003e Send mail.\n\n3. (UN)SUBSCRIBE CONFIRMATION\n\nBy default, the unsubscribe link will direct the user to a confirmation page. Upon confirmation the user is directed to the home page, where a message will be displayed. On the Simplenews subscription admin page you can specify an alternative destination page: Configuration \u003e Web Services \u003e Newsletters \u003e edit newsletter category \u003e Subscription settings\n\nTo skip the confirmation page you can add parameters to the subscription URL.\n  Example: [simplenews-subscribe-url]/ok\n\nWhen an alternative destination page has been defined the extra parameters will be added to the destination URL.\n  Example: [simplenews-subscriber:subscribe-url]/ok\n  Destination: node/123\n  Destination URL: node/123/ok\n\n4. SINGLE OR DOUBLE OPT-IN AND OPT-OUT\n\nEvery newsletter can be set to be double opt-in/out (default), single opt-in/out, or hidden.\n- Double: A confirmation email is sent to confirm the (un)subscribe action. No confirmation is sent when a user is (un)subscribed by the administrator or when the user subscribes when creating an account.\n- Single: No confirmation email is sent. (un)subscribe is immediately.\n- Hidden: The newsletter is not listed in newsletter lists. Use this for mandatory newsletters. Only administrators or modules can add a user to this mailing list.\n\nNote that single opt-in/out or hidden (forced) subscription is in some countries forbidden by law.\n\nSECURITY NOTICE: a newsletter set to be single opt-in or opt-out is vulnerable to Cross Site Request Forgeries. Email addresses may be (un)subscribed without a notice. Do not use this setting in uncontrolled environments (like the internet!).\n\n5. TIPS\n\n* A subscription page is available at: /newsletter/subscriptions\n\n* The Elysia Cron module (https://backdropcms.org/project/elysia_cron) can be used to start the SimpleNews cron hook more often than others, so that newsletters are sent faster without decreasing site performance due to long-running cron hooks.\n\nRelated modules\n------------\n\n * Elysia Cron\n   Allows fine-grained control over cron tasks.\n   https://backdropcms.org/project/elysia_cron\n * Mailsystem\n   Extends Backdrop core mailsystem with Administrative UI and Developers API.\n   https://backdropcms.org/project/mailsystem\n * Maillog\n   Captures outgoing mails, helps users debugging SimpleNews.\n   https://backdropcms.org/project/maillog\n\nCredits\n-------\n\nThis module is based on the SimpleNews module for Drupal, originally written and maintained by a large number of contributors, including:\n\n- [Berdir](https://www.drupal.org/u/berdir)\n- [miro_dietiker](https://www.drupal.org/u/miro_dietiker)\n- [Simon Georges](https://www.drupal.org/u/simon-georges)\n- [Sutharsan](https://www.drupal.org/u/sutharsan)\n- [AlexisWilke](https://www.drupal.org/u/alexiswilke)\n\nCurrent maintainers\n-------------------\n\nSimpleNews is ported and supported by Backdrop Professionals at AltaGrade (https://www.altagrade.com):\n\n* [Alan Mels](https://github.com/alanmels)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbackdrop-contrib%2Fsimplenews","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbackdrop-contrib%2Fsimplenews","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbackdrop-contrib%2Fsimplenews/lists"}