Abonneren op Categorie

Omschrijving

Met deze plug-in kan een gebruiker zich aan- en afmelden voor berichten binnen een bepaalde categorie of categorieën.
Abonnees ontvangen een e-mailbericht met een link naar complete bericht.

Voor een compleet overzicht van STC lees: STC’s gebruikershandleiding versie 2.5.9.
Dit document bevat ook een hoofdstuk (“Step by Step guide to get started with STC”) om aan de slag te gaan.

De volgende functies zijn beschikbaar

  • E-mailmeldingssjabloon met tekstvelden
  • Eigen bericht types
  • Eigen taxonomie types
  • Zoeken op trefwoorden in titel, inhoud, tags en taxonomieën
  • E-mailmelding op timer- of dagelijkse basis
  • SMS kennisgeving op timer of dagelijkse basis
  • Voor nieuwe en / of bijgewerkte berichten
  • Werkt met klassieke editor en de blokeditor
  • Exporteren en Importeren van abonnees
  • Implementatie door middel van een widget en / of shortcode.

Gebruik

Voor een compleet overzicht van STC’s functionaliteit lees: STC’s Gebruikershandleiding

Schermafdrukken

  • Instellingen pagina voor STC met de menu structuur en aanwijzingen
  • Met Bootstrap framework.
  • Zonder Bootstrap-framework, negeer en voeg uw eigen CSS toe.
  • Wanneer het opnieuw verzenden van berichten is ingeschakeld in de instellingen, is er een nieuwe optie beschikbaar bij het bewerken van een bericht.
  • Als de "post opnieuw verzenden" en de "Gutenberg-editor" beide zijn ingeschakeld, komt de optie voor opnieuw verzenden van het bericht beschikbaar op het tabblad Gutenberg-document.
  • Mogelijkheid tot het kiezen van taxonomie(s)
  • Lijst met STC-abonnees met één geregistreerde taxonomie genaamd "Taxonomies"
  • Abonneer mogelijkheden (getoond als boomstructuur)
  • Abonneer mogelijkheden (getoond als lijst)
  • Notificatie e-mail met de plaatsen waar HTML tekst is/kan worden toegevoegd.
  • E-Mail bericht template, aangemaakt door STC
  • Widget Attributes Instellingen

Installatie

In dit gedeelte wordt beschreven hoe u de plug-in installeert en hoe je deze kunt laten werken.

  1. Upload subscribe-to-category naar de /wp-content/plugins/ directory
  2. Activeer de plug-in via het menu ‘Plug-ins’ in WordPress Admin
  3. Bekijk en bewaar instellingen met de menukeuze STC Abonnees > Instellingen
  4. Maak een pagina en voeg shortcode [stc-subscribe] toe of gebruik de STC Widget om een ​​stc-formulier abonnement weer te geven.
  5. Bekijk/ Nieuw/ Wijzig abonnees met de dashboard menukeuze STC Abonnees -> Abonnees

Shortcode Attributen

Categorie_in’ – Gebruik dit attribuut als je slechts één of meerdere categorieën beschikbaar wilt hebben. De in te voeren waarde is de naam van de categorie. Merk op dat alleen niveau 0 (geen ouder) waarden kunnen worden ingevoerd.
category_id_in’ – Het verschil met hierboven is om de categorie-ID te gebruiken in plaats van de categorienaam.
category_not_in’ – Gebruik dit attribuut als je categorieën wilt uitsluiten voor inschrijving. De in te voeren waarde is de naam van een categorie.
category_id_not_in’ – Het verschil met hierboven is dat je de categorie-ID gebruikt in plaats van de categorienaam.
Voor de bovenstaande attributen kan je een komma teken gebruiken om meerdere categorieën te scheiden, zoals [stc-subscribe category_in=”news, article”].

‘hide_unsubscribe’ – hide_unsubscribe=”true” schakelt de unsubscribe-functie uit, maar alleen als het shortcode-attribuut ook is ingeschakeld bij de admin-instellingen.
treeview_folded’ – treeview_folded=”false” ontvouwt standaard de categorie / taxonomie boomweergave.
‘treeview_enabled’ – treeview_enabled=”false” geeft de categorieën / taxonomieën weer als één lijst waarbij hiërarchie genegeerd wordt. Merk op dat alleen de geselecteerde categorieën in of uit zijn.
keyword_search’ – keyword_search=”on” schakelt het zoeken naar trefwoorden in nieuwe of bijgewerkte geselecteerde post types in. Standaard is keyword_search=”off”.
‘subscriber_notification’ – subscriber_notification=”true” schakelt email notificatie in op een individuele per abonnee basis. Standaard is subscriber_notification=”false”.
mobile_phone” – mobile_phone=”aan” schakelt de SMS Notificatie functie in. Dit zal SMS Notificaties versturen net zoals de E-mail notificaties voor nieuwe of bijgewerkte berichten.

Filter and hooks

De volgende filters en haken kunnen worden gebruikt om het e-mail bericht aan te passen.

<?php
// FILTERS
// Parameters: $value
add_filter( 'stc_message_length_sum_of_words', 'stc_message_length_sum_of_words', 10, 1 ); //set return value to a negative number to show the full content


// Parameters: $value, $post_id, $subscriber_post_id
add_filter( 'stc_message_title_html', 'my_stc_message_title_html', 10, 3 );
add_filter( 'stc_message_link_to_post_html', 'my_stc_message_link_to_post_html', 10, 3 );
add_filter( 'stc_message_unsubscribe_html', 'my_stc_message_unsubscribe_html', 10, 3 );
add_filter( 'stc_message_subscribe_html', 'my_stc_message_subscribe_html', 10, 3 );

// HOOKS
// Parameters: $post_id, $subscriber_post_id  
add_action( 'stc_before_message', 'my_stc_before_message', 10, 2 );
add_action( 'stc_before_message_title', 'my_stc_before_message_title', 10, 2 );
add_action( 'stc_after_message_title', 'my_stc_after_message_title', 10, 2 );
add_action( 'stc_before_message_content', 'my_stc_before_message_content', 10, 2 );
add_action( 'stc_after_message_content', 'my_stc_after_message_content', 10, 2 );
add_action( 'stc_after_message', 'my_stc_after_message', 10, 2 );

// Parameters: $subscriber_post_id, $categories, bool $all_categories
add_action( 'stc_after_update_subscriber', 'my_stc_after_update_subscriber', 10, 3 );
add_action( 'stc_after_insert_subscriber', 'my_stc_after_insert_subscriber', 10, 3 );

// Parameters: $subscriber_post_id, 
add_action( 'stc_before_unsubscribe', 'my_stc_before_unsubscribe', 10, 1 ); // runs before deleting a subscriber from database
add_action( 'stc_before_subscribe', 'my_stc_before_subscribe', 10, 1 ); // runs before adding a subscriber to the database


/**
 * Example for adding featured image to STC email
 */
function my_stc_after_message_title( $post_id ){
    echo get_the_post_thumbnail( $post_id, 'thumbnail' );
}
add_action( 'stc_after_message_title', 'my_stc_after_message_title', 10, 2 );

?>

Optioneel maar aanbevolen

Aangezien WordPress Cron afhankelijk is van het feit dat u bezoeken op uw website heeft, moet u een cron-taak op uw server instellen om met regelmatige tussenpozen op http://uwdomein.com/wp-cron.php te klikken om ervoor te zorgen dat WP-Cron actief is zoals verwacht. In de huidige versie van Abonneren op categorie draait de WP-Cron eenmaal per uur, dat kan een optie zijn die in toekomstige versies kan worden gewijzigd.
Daarom kan een aanbevolen interval voor uw server-cron eens in de 5 minuten zijn.

FAQ

Is het mogelijk om HTML tekst toe te voegen aan de notificatie e-mails

Ja dat kan met de door STC aangemaakte “hooks”. Daarmee kan je op zes verschillende plaatsen in de e-mail notificatie HTML tekst toevoegen. Je hebt daarvoor wel programmeer vaardigheden nodig. In versie 2.4.9 is er een nieuwe manier beschikbaar gekomen wat het een stuk gemakkelijker maakt om tekst aan de e-mail toe te voegen.

Voor een nieuwe start is het de gemakkelijke manier om alle HTML E-Mail sjablonen (gepubliceerd en in de prullenbak ) te verwijderen. Daarop zal STC automatisch een bewerkbaar STC Demo E-mail Template opzetten zoals te zien is in screenshot-11. Vergeet niet om de nieuwe template aan te vinken in de STC Abonnee -> Instellingen.

Of volg onderstaande 3 stappen.
stap 1: STC Abonneren->Notificaties->Nieuw bericht om een nieuw e-mail notificatie sjabloon te maken.
Stap 2: Bewerk het bericht het in de block-editor met een enkel html-blok. Alle stijlen moeten binnen elk HTML-element vallen. Niet alle e-mailproviders kunnen alle HTML-stijlen verwerken. Gebruik de tijdelijke onder andere de aanduidingen {{post_title}}, {{post_content}}, {{justify}} en {{unsubscribe}}.
stap 3: Schakel de vereiste postsjabloon in de STC-admin-instellingen in.

Kunnen attributen ingesteld worden met de STC Widget

Ja, vanaf versie 2.4.16 heeft het instellingengebied van de widget een veld om attributen toe te voegen. Het attribuut formaat is hetzelfde als gebruikt met de shortcodes.

Kan STC omgaan met “Custom Post Types”

Ja sinds versie 2.4.1 kan STC omgaan met “Custom Post Types”. De CPT’s kunnen geselecteerd worden op de STC admin settings pagina

Kan STC omgaan met taxonomieën

Ja vanaf versie 2.3.1 is het mogelijk om STC te koppelen aan geregistreerde publieke taxonomieën. Je kunt deze taxonomieën binnen STC activeren op de admin settingspagina van STC.

Waarom kunnen bij gebruik van “in” filters alleen level 0 (ouders) categorieën / taxonomieën opgegeven worden

Dit komt omdat een niet level 0 categorie / taxonomie niet zonder een ouder getoond kan worden. Als het treeview_enabled=”false” actief is kan het wel.

Kan de categorie / taxonomie tree view ook als lijst getoond worden.

Categorieën en Taxonomieën als lijst tonen kan door het toevoegen van de attribuut: treeview_enabled=”false”. Houd er rekening mee dat categorie in filters dan precies de opgegeven categorieën / taxonomieën toevoegen die in het filter zijn opgegeven.

Welk formaat is nodig voor het importeren van abonnees?

STC kan alleen omgaan met een tab als delimiter omdat er al comma’s worden gebruikt om de categorieën van elkaar te scheiden.
Excel (onder andere) heeft de mogelijkheid om tab delimited export bestanden te maken.

Beoordelingen

6 mei 2021
This plugin does exactly what it should and it comes with amazing support. Some other review says: "Do one thing and do it well" I totally agree.
6 april 2021
Curious about functionality: What I am looking is: as blog Reader, be able to subscribe only to certain Categories in Posts (get emails). Doable?
15 maart 2021
Our deepest gratitude, Sidney. This is wonderful and so is your support with the odd array of challenges specific to my client's site and setup. Highly recommend. I'd encourage the developers to create a Pro version - we will happily purchase.
10 februari 2021
I ran into a glitch with custom posts being accidentally pushed out on republish. After I reported the bug to the support forum, vandestouwe not only replied within no time at all, but also fixed it and developed a new feature in the process. Amazing!
Lees alle 27 beoordelingen

Bijdragers & ontwikkelaars

“Abonneren op Categorie” is open source software. De volgende personen hebben bijgedragen aan deze plugin.

Bijdragers

“Abonneren op Categorie” is vertaald in 5 talen. Dank voor de vertalers voor hun bijdragen.

Vertaal “Abonneren op Categorie” naar jouw taal.

Interesse in ontwikkeling?

Bekijk de code, haal de SVN repository op, of abonneer je op het ontwikkellog via RSS.

Changelog

  • Added attribute to show taxonomy hierarchy in the reason why a notification was sent.

2.5.9

  • Added attribute to show taxonomy hierarchy in the reason why a notification was sent.
  • minor bug fixes

2.5.8

  • Opgelost waarschuwing als folder of bestand niet bestaat
  • Problemen met containers met twee of meer kolommen opgelost

2.5.7

  • bevestigingspagina slug toegevoegd: stcs-bevestigingspagina voor fase één van e-mailbevestiging
  • SMS kennisgeving functie toegevoegd (werkt alleen met TextMagic als sms-provider)
  • Probleem opgelost met onderwerp van e-mail kennisgeving
  • Probleem opgelost waarbij sommige sms-berichten verkeerd werden gemengd met Blog waar het Bericht zou moeten zijn
  • Probleem opgelost met dit bericht niet verzenden bij nieuw/update
  • kleine foutverbeteringen.

2.5.5

  • added landingspage with slug stcs-landing-page
  • solved bug in succesfull reply on import susbscribers
  • solved bug in subscribers not having a proper default value for individual subscribtions

2.5.4

  • new placeholders
  • choice for weekdays, daily and hourly notifications on individual basis
  • problem with word / character cutoff in middle of html tag’s
  • small bugfixes

2.5.3

  • nieuwe plaatshouder toegevoegd {{post_excerpt}}
  • nieuwe plaatshouder toegevoegd {{post_featured_image}}
  • nieuwe STC Basic e-mail template V2.1 (verwijder oudere versies)
  • opgelost probleem {{search_reason}} met “” in sommige gevallen.

2.5.2

  • mogelijkheid toegevoegd in bericht document zijbalk om e-mailvermeldingen te verhinderen
  • Negeer standaard boomweergave ingeschakeld wanneer categoriekenmerken worden gebruikt in dezelfde shortcode, dit maakt het mogelijk om STC te upgraden van oudere (vóór boomweergave) versies

2.5.1

  • revised readme.txt and introduction of STC’s User Manual
  • Added enhanced keyword search facilities.
  • Added stc_update_count_callback function which filters out the terms count for custom post type ‘stc’.
  • Check for STC meta keys present on custom posts created by others. Add STC meta keys/values if not present.
  • Added more placeholders to control the e-mail notification template
  • For newly created e-mail notification post are created with content explanatory content and possible placeholders.
  • small bugfixes

2.4.18

  • Removal of all the non textual tags preventing cutoff’s causing e-mail layout failure
  • Added multibyte characters count for the E-Mail Notification
  • Added hidden

tags to separate multiple updates and / or saves posts. HR styling is available in body class “stc-notify-hr”
* Added workaround to control justification in the contents row of the e-mail notification template. text-align: left”>{{post_content}} is used by STC to replace the word left for center allowing dynamic justification depending on content cutoff is 0 or > 0
* small bugfixes

2.4.17

  • Created “STC Demo E-mail Template V1.1” to enable background-color style change with Chinese SMTP provider (tested with outlook, gmail and exmail).
  • Improved handling of E-mail Template
  • small bugfixes

2.4.16

  • Unsubscribe via e-mail link firing more then once causing incorrect fault message
  • New single HTML E-mail Notification layout with placeholders for title, content and unsubscribe
  • Widget settings for STC Widget: new possibility to use shortcode attributes
  • small bugfixes

2.4.14

  • adding a feature to send all email notifications once per day
  • revised the STC Settings Notification E-mail status pane
  • small bugfixes

2.4.12

  • Added/Revised code and HTML section post to create an initial html template setup like in screenshot-11. Delete all HTML sections (published and trashed) to replace existing HTML sections
  • corrected quite a view spelling mistakes in messages and readme.txt
  • small bugfixes

2.4.11

  • Redesigned the STC menu structure. Dashboard: STC Subscribe => Submenu: (Settings, Notifications, Subscribers)
  • Added code to create the basic notification structure automatically (if HTML section names not checked && post does not exist) {wp_insert_post(….)}
  • small bugfixes

2.4.10

  • created a way that categories are default on until the user itself disables it through STC admin settings
  • redesigned option structure for compatibility reasons

2.4.9

  • major change in adding HTML text to the notification e-mail (read FAQ concerning HTML inserts)
  • categories can now be disabled to accommodate users whom only work with custom taxonomies
  • small bugfixes

2.4.8

  • small bug fixes.

2.4.7

  • STC used sendmail instead of PHPMailer because in version 5.5 from Wordpres wp_mail cant cope with a encoded_basic64. Analasys of the PHPMailer’s showed that it takes care of 8 bit characters itself so no need to do this in STC. wp_mail() again used enabling Mail plugins to pick up STC mails.

2.4.6

  • added attribute ‘treeview_folded’ – treeview_folded=”false” unfolds the category / taxonomy tree view by default
  • added attribute ‘treeview_enabled’ – treeview_enabled=”false” displays the categories / taxonomies as one list ignoring hierarchy. Please note that only the selected categories are in or out
  • added/changed some French translations
  • small bug fixes.

2.4.5

  • filter categories caused the tree view to be messed up completely now any category can be taken out but only categories of level 0 can be filtered in.

2.4.4

  • allow for no categories or taxonomies selected at all
  • fixed issue that subscribers in trash taxonomies where picked up
  • fixed issue displaying wrong indent for category and taxonomy treeview

2.4.3

  • fixed issue on shortcodes attributes: category_in, category_id_in, category_not_in, category_id_not_in

2.4.2

  • fixed issue on STC settings page when no custom post or no custom taxonomies where available
  • fixed issue on subscription warning when no taxonomies where selected
  • fixed issue on first use of the block editor STC resend checkbox

2.4.1

  • Added Custom Posts Functionality
  • Minor bugfixes

2.3.9

  • Fixed error in CSS file stc-tax-style.css causing CSS optimization to fail

2.3.8

  • Revised category and taxonomy selection for the shortocde and widget
  • Several changes to make understand STC better
  • Fix bug in wp-mail sending corrupted base64 encode subject in notification
  • Other bugfixes

2.3.6

*bugfixes

2.3.5

  • Small changes to adapt to WP 5.5
  • bugfixes

2.3.1

  • New admin setting to select custom taxonomies names (shortcode for taxonomy selection comes later for now use admin edit of subscription)
  • Muliple post to one subcriber are added together in one notification.
  • bugfixes

2.2.1

  • Introduced subscriber verification for subscriptions and updates while not logged in to WordPress
  • Introduced disabling of the unsubscribe checkbox
  • New admin setting to control the length of the content in the email notification
  • bugfixes

2.1.7

  • Added email conformation to intended STC subscriber. When confirmed the new stc subscriber becomes active. This is not required when the user is in admin mode.

2.1.6

  • minor bugfixes

2.1.5

  • changed subscription method for existing subscribers to enable updating the subscription
  • bug fixed with only one category causing nothing to show

2.1.4

  • Changed tekst for using the Gutenberg/Block editor to be more clear
  • Redirect to first page after subscription stays now on the current page
  • Bug fixed causing not to update the subscribers when using the classic WP editor

2.1.3

  • Added an admin feature to import a csv subscriber list in exactly the same format as created by the export function

2.1.2

  • Added an admin setting to control the WP-Cron STC rescheduling “send email time”. Default is 3600 second but the user can now set it to any value between 180 and 3600 ( 2 minutes and 1 hour)

2.1.1

  • during sanitizing process the email address from the un-subscriber lost the “@” sign causing failed un-subscription issues

2.1.0

  • implemented sanitizing and escaping according WPCS
  • adapted internationalization text domain to plugin standards
  • added ‘numberposts’ => -1 to the args for exporting all subscribers to excel it was defaulting to a maximum of 5
  • minor bugfixes

2.0.0

  • adapted STC to WP 5.3 features by adding a STC resend option to the document tab

1.9.0

  • Email address preset for logged in users.
  • Japanese, Dutch, German and Norwegian language added.

1.8.1

  • Added pot file to be used for translation.
  • Bugfix – changed textdomain to string instead of constant.

1.7.0

  • Added some new hooks: stc_after_update_subscriber, stc_after_insert_subscriber, stc_before_unsubscribe.

1.6.0

  • Added a Widget for subscription form.
  • Don’t show category list if only one is available (thanks to davefx).
  • Extended short code attributes with an option to use category id instead of category name (thanks to Stingray_454).

1.3

  • Added hooks and filters to make the plugin extensible.
  • Added Lithuanian language.

1.2.1

  • Fixed some undefined variables that might have caused some errors for some environments.
  • Renamed language files for Russian language to correct syntax.
  • Added Italian language.

1.2.0

  • Possibility to re-send a post on update that has already been sent. This option needs to be activated in the settings for the plugin.
  • Attribute ‘category_in’ added to shortcode to show only entered categories in the subscribe form. Multiple categories are separated by a comma sign.
  • Attribute ‘category_not_in’ added to shortcode to exclude categories in the subscribe form. Multiple categories are separated by a comma sign.

1.1.0

  • Added php sleep() function to prevent sending all e-mails in the same scope.
  • Using Ajax when send is manually triggered in back-end.

1.0.0

  • First release