{"id":265902,"date":"2025-12-10T10:58:29","date_gmt":"2025-12-10T10:58:29","guid":{"rendered":"https:\/\/fa.wordpress.org\/plugins\/bilbok-bulk-mailer-for-flamingo\/"},"modified":"2025-12-10T11:31:04","modified_gmt":"2025-12-10T11:31:04","slug":"bilbok-bulk-mailer-for-flamingo","status":"publish","type":"plugin","link":"https:\/\/kir.wordpress.org\/plugins\/bilbok-bulk-mailer-for-flamingo\/","author":17146949,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_crdt_document":"","version":"3.0.0","stable_tag":"trunk","tested":"6.9.4","requires":"5.6","requires_php":"7.4","requires_plugins":null,"header_name":"Bilbok Bulk Mailer for Flamingo","header_author":"DERHAL.IR","header_description":"Send bulk email campaigns to your Flamingo contacts with safe queue and rate limiting.","assets_banners_color":"","last_updated":"2025-12-10 11:31:04","external_support_url":"","external_repository_url":"","donate_link":"https:\/\/derhal.ir","header_plugin_uri":"https:\/\/derhal.ir\/bilbok-bulk-mailer-for-flamingo","header_author_uri":"https:\/\/derhal.ir","rating":0,"author_block_rating":0,"active_installs":0,"downloads":160,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":[],"upgrade_notice":{"3.0.0":"<p>First public release on WordPress.org.<br \/>\nPlease review your SMTP settings and test sending before using it in production.<\/p>"},"ratings":[],"assets_icons":[],"assets_banners":[],"assets_blueprints":{},"all_blocks":[],"tagged_versions":[],"block_files":[],"assets_screenshots":[],"screenshots":{"1":"Campaigns list with status, sent\/remaining counters, and actions.","2":"Campaign creation form (name, Flamingo channel, manual emails, schedule).","3":"Settings page with From address, rate limiting, test email, credit footer and blacklist."},"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[26810,1152,142610,455,252038],"plugin_category":[42],"plugin_contributors":[252036],"plugin_business_model":[],"class_list":["post-265902","plugin","type-plugin","status-publish","hentry","plugin_tags-bulk-mail","plugin_tags-contact-form-7","plugin_tags-email-sender","plugin_tags-newsletter","plugin_tags-tags-flamingo","plugin_category-contact-forms","plugin_contributors-derhal","plugin_committers-derhal"],"banners":[],"icons":{"svg":false,"icon":"https:\/\/s.w.org\/plugins\/geopattern-icon\/bilbok-bulk-mailer-for-flamingo.svg","icon_2x":false,"generated":true},"screenshots":[],"raw_content":"<!--section=description-->\n<p><strong>Bilbok Bulk Mailer for Flamingo<\/strong> lets you send bulk email campaigns to your existing contacts stored by the <a href=\"https:\/\/wordpress.org\/plugins\/flamingo\/\">Flamingo<\/a> plugin (which is usually fed by <a href=\"https:\/\/wordpress.org\/plugins\/contact-form-7\/\">Contact Form 7<\/a>).<\/p>\n\n<p>The plugin focuses on:<\/p>\n\n<ul>\n<li><strong>Safety<\/strong> \u2013 emails are sent via a queue with a configurable hourly rate (e.g. 80 emails\/hour for Gmail).<\/li>\n<li><strong>Campaigns<\/strong> \u2013 create named campaigns, pick a Flamingo channel and\/or add manual email addresses, and let the plugin send them in the background.<\/li>\n<li><strong>Deliverability<\/strong> \u2013 plays nicely with SMTP plugins (e.g. Gmail), avoids spikes, and includes an unsubscribe blacklist.<\/li>\n<li><strong>Branding<\/strong> \u2013 (optional) credit footer at the bottom of each outgoing email.<\/li>\n<\/ul>\n\n<blockquote>\n  <p>This plugin <strong>does not<\/strong> scrape or collect any emails by itself. It only sends to contacts that already exist in your Flamingo address book and the manual addresses you provide.<\/p>\n<\/blockquote>\n\n<h3>Features<\/h3>\n\n<ul>\n<li>Create and manage email <strong>campaigns<\/strong>.<\/li>\n<li>Select recipients from <strong>Flamingo channels<\/strong> (per CF7 form).<\/li>\n<li>Add <strong>manual email addresses<\/strong> (one per line) to a campaign.<\/li>\n<li>Queue\u2011based sending with <strong>rate limiting<\/strong> (e.g. 80 emails\/hour).<\/li>\n<li>Campaign statuses: <code>pending<\/code>, <code>running<\/code>, <code>paused<\/code>, <code>completed<\/code>.<\/li>\n<li>Start \/ pause \/ edit \/ delete campaigns from one screen.<\/li>\n<li><strong>Blacklist (unsubscribe)<\/strong> \u2013 a global list of email addresses that will be excluded from all campaigns.<\/li>\n<li>Optional <strong>credit footer<\/strong> in each outgoing email:\n&gt; \"This email was sent with Bilbok Bulk Mailer for Flamingo by DERHAL.IR\"<\/li>\n<li>Send test emails:\n\n<ul>\n<li>Global test email from the settings page.<\/li>\n<li>Campaign\u2011specific test email before launching a campaign.<\/li>\n<\/ul><\/li>\n<li>Fully translatable (i18n ready). English is the default. A sample <code>fa_IR<\/code> translation can be added.<\/li>\n<li>Clean, self\u2011contained code; no external SaaS, no phone\u2011home.<\/li>\n<\/ul>\n\n<h3>Requirements<\/h3>\n\n<ul>\n<li><a href=\"https:\/\/wordpress.org\/plugins\/flamingo\/\">Flamingo<\/a> plugin (for the <code>flamingo_inbound<\/code> post type and channels).<\/li>\n<li>(Recommended) An SMTP plugin, e.g.:\n\n<ul>\n<li><a href=\"https:\/\/wordpress.org\/plugins\/wp-mail-smtp\/\">WP Mail SMTP<\/a><\/li>\n<li><a href=\"https:\/\/wordpress.org\/plugins\/post-smtp\/\">Post SMTP<\/a><\/li>\n<\/ul><\/li>\n<li>PHP 7.4 or higher.<\/li>\n<\/ul>\n\n<!--section=installation-->\n<ol>\n<li>Upload the plugin folder <code>bilbok-bulk-mailer-for-flamingo<\/code> to the <code>\/wp-content\/plugins\/<\/code> directory, or install it through the WordPress Plugins screen.<\/li>\n<li>Activate the plugin through the \u201cPlugins\u201d screen in WordPress.<\/li>\n<li>Make sure the <strong>Flamingo<\/strong> plugin is installed and active (contacts and channels come from Flamingo).<\/li>\n<li>Go to <strong>Bilbok Bulk Mailer \u2192 Settings<\/strong> and:\n\n<ul>\n<li>Set the <strong>From email address<\/strong> (must match the email in your SMTP plugin).<\/li>\n<li>Set the <strong>max emails per hour<\/strong> (e.g. 80 for personal Gmail).<\/li>\n<li>Set your default <strong>test email<\/strong> address.<\/li>\n<li>(Optional) Keep the \u201cShow credit footer\u201d option enabled if you want the credit line in your emails.<\/li>\n<li>(Optional) Add one or more email addresses to the <strong>Blacklist<\/strong> (one per line).<\/li>\n<\/ul><\/li>\n<li>Go to <strong>Bilbok Bulk Mailer \u2192 Campaigns<\/strong> to create your first campaign:\n\n<ul>\n<li>Click <strong>Add New Campaign<\/strong>.<\/li>\n<li>Enter a <strong>campaign name<\/strong>.<\/li>\n<li>(Optional) Select a <strong>Flamingo channel<\/strong> (this corresponds to a CF7 form).<\/li>\n<li>(Optional) Enter <strong>manual email addresses<\/strong>, one per line.<\/li>\n<li>Set the <strong>From email<\/strong>, <strong>rate per hour<\/strong>, and <strong>start time<\/strong>.<\/li>\n<li>Enter the <strong>email subject<\/strong> and <strong>HTML content<\/strong>.<\/li>\n<li>Use <strong>\u201cSend test campaign\u201d<\/strong> to send a test email to yourself.<\/li>\n<li>When you are satisfied, click <strong>\u201cCreate campaign and enqueue emails\u201d<\/strong>.<\/li>\n<\/ul><\/li>\n<li>The built\u2011in cron task (<code>bilbok_cf7bm_cron_send<\/code>) runs every 5 minutes and processes the queue:\n\n<ul>\n<li>Only <strong>one campaign<\/strong> runs at a time (oldest pending\/running first).<\/li>\n<li>Emails are sent gradually up to the configured rate per hour.<\/li>\n<\/ul><\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id='does%20this%20plugin%20send%20spam%3F'><h3>Does this plugin send spam?<\/h3><\/dt>\n<dd><p>No. The plugin simply sends email campaigns to:<\/p>\n\n<ul>\n<li>Contacts saved in Flamingo (via your existing Contact Form 7 forms).<\/li>\n<li>Manual email addresses you provide.<\/li>\n<\/ul>\n\n<p>You are fully responsible for complying with email laws (GDPR, CAN\u2011SPAM, etc.) and only sending to people who have given you permission.<\/p><\/dd>\n<dt id='can%20i%20use%20it%20with%20gmail%3F'><h3>Can I use it with Gmail?<\/h3><\/dt>\n<dd><p>Yes, and it is designed with Gmail\u2019s limits in mind:<\/p>\n\n<ul>\n<li>You can configure a <strong>max emails\/hour<\/strong> value (for example 80) in the settings.<\/li>\n<li>The queue is processed every 5 minutes, dividing your hourly rate into small chunks.<\/li>\n<li>Make sure to use an SMTP plugin configured with your Gmail or Google Workspace account.<\/li>\n<\/ul><\/dd>\n<dt id='does%20it%20work%20without%20flamingo%3F'><h3>Does it work without Flamingo?<\/h3><\/dt>\n<dd><p>No. This plugin is specifically designed to work with Flamingo contacts and channels.<br \/>\nHowever, you can still send to <strong>manual email addresses<\/strong> in addition to Flamingo channels.<\/p><\/dd>\n<dt id='can%20i%20change%20or%20remove%20the%20credit%20footer%3F'><h3>Can I change or remove the credit footer?<\/h3><\/dt>\n<dd><p>Yes:<\/p>\n\n<ul>\n<li>In <strong>Settings \u2192 Show credit footer<\/strong>, you can disable the footer entirely.<\/li>\n<li>Developers can customize the footer HTML using the filter:\n  bilbok_cf7bm_email_footer_html.<\/li>\n<\/ul><\/dd>\n<dt id='how%20does%20the%20blacklist%20%2F%20unsubscribe%20feature%20work%3F'><h3>How does the blacklist \/ unsubscribe feature work?<\/h3><\/dt>\n<dd><p>In <strong>Settings \u2192 Email blacklist<\/strong> you can enter one email address per line.<br \/>\nThose addresses will be excluded from all campaigns even if they appear in Flamingo or manual lists.<\/p><\/dd>\n<dt id='can%20i%20change%20the%20recipients%20of%20an%20existing%20campaign%3F'><h3>Can I change the recipients of an existing campaign?<\/h3><\/dt>\n<dd><p>No. Once a campaign has been created, its recipient list is frozen to preserve queue integrity.<br \/>\nIf you need different recipients, create a <strong>new<\/strong> campaign.<\/p><\/dd>\n<dt id='is%20this%20plugin%20gdpr%20compliant%3F'><h3>Is this plugin GDPR compliant?<\/h3><\/dt>\n<dd><p>The plugin does not collect any personal data beyond what Flamingo (and CF7) already store.<br \/>\nHowever, you are responsible for:<\/p>\n\n<ul>\n<li>Having a proper legal basis for emailing your contacts.<\/li>\n<li>Providing an unsubscribe mechanism (the blacklist feature can be part of that).<\/li>\n<\/ul><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>3.0.0<\/h4>\n\n<ul>\n<li>Initial public release.<\/li>\n<li>Campaigns (create, start, pause, edit, delete).<\/li>\n<li>Queue\u2011based sending with rate limiting (per hour).<\/li>\n<li>Flamingo channel integration and manual email addresses.<\/li>\n<li>Email blacklist (unsubscribe).<\/li>\n<li>Optional credit footer in outgoing emails.<\/li>\n<li>Admin UI ready for translation (i18n).<\/li>\n<\/ul>","raw_excerpt":"Send bulk email campaigns to your Flamingo contacts (Contact Form 7) with a safe queue, Gmail\u2011friendly rate limiting, and campaign management.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/kir.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/265902","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/kir.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/kir.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/kir.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=265902"}],"author":[{"embeddable":true,"href":"https:\/\/kir.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/derhal"}],"wp:attachment":[{"href":"https:\/\/kir.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=265902"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/kir.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=265902"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/kir.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=265902"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/kir.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=265902"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/kir.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=265902"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/kir.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=265902"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}