Description
Show published duty notary lists on your WordPress site. NOTERLİKLER lets visitors choose a province, district and published date, then open notary details without leaving the widget.
Addresses, phone numbers, opening hours, lunch breaks and directions are brought together in a responsive interface for desktop and mobile screens.
What your visitors can do
- Select a province and district by name.
- Browse the dates published by Noterlikler.com.tr, including weekends and public holidays when available.
- Open a notary’s contact details, working hours and published duty dates inside the widget.
- Copy an address, start a phone call or open directions in Google Maps.
- See a clearly labelled regular weekday directory when a location has no published duty record.
Add it your way
Use the [noterlikler] shortcode, the Gutenberg block or the classic widget. Set a default location and adjust the theme, layout, card count, text size and corners from the Turkish settings panel with a live preview.
Choose light, dark or green themes and list, compact or horizontal layouts. Widget styles are isolated with Shadow DOM, and no remote JavaScript, CSS or fonts are loaded by the plugin.
Video walkthrough
The Turkish video shows the list, notary details, mobile layout and settings panel. Screenshots use published records available when the demonstration was captured; the plugin retrieves the service’s latest available records.
Before you install
The plugin requires PHP 8.2 or later and a connection from your WordPress server to Noterlikler.com.tr. Schedule changes are maintained by the data service; you do not need to install a new plugin version each week. Keep the plugin updated for security and compatibility fixes.
Explore the service | Widget and integration information
External service
Service: https://noterlikler.com.tr/
API: https://noterlikler.com.tr/api/v1/
List and detail service: https://noterlikler.com.tr/widget/veri and https://noterlikler.com.tr/widget/noter/{slug}
Terms: https://noterlikler.com.tr/kullanim-sartlari
Privacy: https://noterlikler.com.tr/gizlilik-politikasi
This plugin is a client for the Noterlikler.com.tr data service. Installing, activating and configuring the plugin or inserting its widget uses this service as its core function. Displaying a widget or its settings preview sends the selected province and district codes, date, list page and selected notary slug from the WordPress server to the service. Visitor IP addresses, personal information, site URLs and access tokens are not forwarded. The service sees the WordPress server’s IP address as part of the connection. It returns location names, addresses, phone numbers and schedule dates. Selecting a directions link opens Google Maps. The plugin does not load remote JavaScript or CSS.
Source code
All first-party JavaScript and CSS source is included in human-readable, unminified form in assets/widget.js, assets/admin.js, assets/editor.js, assets/widget.css and assets/admin.css. These exact files are loaded by WordPress; there are no separate generated/minified runtime files, source downloads or JavaScript/CSS build steps. Edit these source files directly. PHP source is in noterlikler.php and includes/. No bundled third-party JavaScript/CSS libraries or remote scripts/styles are used. The block editor uses the WordPress-provided wp-* dependencies.
Public proxy protection
Province/district combinations are checked against the bundled location list before any remote request. Detail links carry a short-lived, site-specific HMAC issued only for notary slugs returned by the list service; arbitrary slugs without a matching token never reach the service. Tokens contain no visitor data and are not forwarded upstream.
All successful and failed data responses share 128 fixed cache slots. Each slot verifies its selection identity, so a collision causes a cache miss rather than another selection’s data. Random inputs cannot create unlimited database cache entries. All routes share a site-wide budget of 120 outgoing requests per minute and at most four simultaneous service requests. Valid cached responses do not consume this budget. During service outages a shared ten-second cooldown prevents repeated failed requests. Limits use fixed keys and do not store visitor IPs. This limits the plugin’s own work; host/CDN protections are still needed for large traffic attacks.
Installation
- In WordPress, open Plugins > Add New, search for NOTERLİKLER and install it. You can also upload its ZIP using Upload Plugin.
- Activate it and customize the widget in Settings > Nobetci Noter. The data service works automatically.
- Add [noterlikler], the Nobetci Noter block, or the classic widget.
Example: [noterlikler province=”34″ theme=”light” limit=”5″]
Attributes: province (01-81), district (district code), theme (light/dark/green), layout (list/compact/horizontal), limit (1-12), font (12-20), radius (0-24).
FAQ
How does caching work?
WordPress caches API data for at most 60 seconds and never beyond the validity deadline returned by the service. Saturday’s removal deadline is 17:30 and other days use 18:00, in Europe/Istanbul time. Cached page HTML contains a loading area rather than old schedule records. Data is fetched through the local WordPress REST endpoint, and open pages refresh when the response expires. Expired records are not served on network failure. Changes normally appear within the short cache lifetime.
What if I use a page cache or CDN?
Exclude /wp-json/ntrw/v1/* from page and CDN caching. Responses carry no-store headers; a CDN configured to override these headers needs a separate exclusion. Exclude the ntrw script from optimization settings that delay JavaScript until user interaction.
Where can I find district codes?
Province and district names are shown in the settings panel when you select a province. The panel generates a shortcode containing the selected codes.
Does the plugin include a settings panel?
Yes. Site administrators can change the default province and district, theme, layout, card limit, font size and corner radius. They can view a preview, generate a shortcode, refresh the cache and use the included source attribution.
What happens on uninstall?
The plugin deletes its own settings, widget options and database-based temporary caches. Existing external object-cache entries expire naturally. It does not delete posts or the service’s notary database.
Screenshots
Changelog
1.2.9
Readable, unminified runtime source; local district validation, signed detail links, bounded cache slots, shared upstream request budget and outage cooldown.
1.2.8
Reference-inspired responsive list and details, Shadow DOM style isolation, accessible navigation and improved compact layouts.
1.2.7
Responsive list and in-widget notary details, two-line date buttons, directory fallback and isolated styles. Existing shortcodes, saved settings and PHP 8.2 support remain compatible.
1.2.6
Display name updated to NOTERLIKLER; requested directory slug and text domain: noterlikler. Existing shortcodes, block identifiers and saved settings are preserved.
1.2.5
PHP 8.2 compatibility: removed typed class constants and lowered the minimum PHP requirement.
1.2.4
Improved readable admin notices, instant unsaved preview, province headings, centered date buttons and bundled brand icon. Added [noterlikler] while retaining the old shortcode as an alias. The documented core data service works automatically.
1.1.1
Updated the display name to Nobetci Noter Listesi – Noterlikler and aligned the package with the nobetci-noter slug.
1.1.0
PHP 8.5 requirement, typed API boundaries, deferred script loading and stricter output validation.
1.0.0
Initial release with a date-based API, bounded cache, block, shortcode and widget.




