Bildirim — Web Push Notifications

Preguntas frecuentes

Do I need the manifest option?

Only for iPhone and iPad. iOS delivers push exclusively to sites the user added
to their Home Screen, and that requires an installable manifest. Chrome,
Firefox and Edge do not need it. Leave the option off if your site already has
its own manifest.json — the plugin will not overwrite it.

Why is the service worker written to the site root instead of uploads?

Because a service worker can only control the paths below its own URL, and
browsers refuse to load one from another origin. Bildirim’s SDK registers
/bildirim/BildirimSDK-sw.js, and the server-side installation check requires
exactly that path on your own domain, so the plugin cannot invent a location
under wp-content/uploads.

It is one 236-byte file in a single bildirim/ folder. The plugin uses the
WP_Filesystem API (never direct file functions), and if the filesystem is not
writable it does not fail: it falls back to serving the same bytes dynamically
through a rewrite rule, so no write is required for the plugin to work. On
deactivation it removes that file and only that file, after checking the
content for a Bildirim marker.

Will deactivating the plugin delete my files?

It removes the service worker file it created, and only that file: the content
is checked for a Bildirim marker first, so a worker you replaced by hand stays
where it is. Settings are removed on uninstall, and only if you left that
option enabled.

Does it work with caching plugins?

Yes. The script tag carries exclusion attributes for the common optimisers and
the plugin registers their filters. If an optimiser still merges the tag, push
keeps working but SDK updates stop arriving — exclude it manually then.

How do I announce new posts?

Go to Settings → Bildirim and press Enable sending from WordPress.
Bildirim verifies that this site really is yours (it asks your site for a
one-time code) and hands the plugin a send-only key — no dashboard visit, no
copying credentials by hand. A “Bildirim” box then appears on the post editor
with a send switch and channel checkboxes (Web / iOS / Android). Publish the
post and it goes out; there is also a “Send now” button for posts that are
already published.

What can the key from “Enable sending” do?

Only send notifications for this project. It cannot read your subscriber list,
change settings or create other keys. It is listed in the dashboard under
Settings → Keys and can be revoked there at any time; the project owner also
gets an email when it is issued.

Will editing a post send a second notification?

No. A post is announced once; the box shows when it was sent. Use “Send again”
if you really want a second notification.

Why does my notification not go out?

The plugin shows the API’s own message on the post screen. The most common one
is the send gate: a project cannot broadcast until its domain is verified and
one test notification was delivered. Both are done from the dashboard’s Setup
screen.

Is the secret key safe in WordPress?

It is stored in your site’s options table and shown masked. Treat it as a
credential: anyone who can administer this site can send notifications to your
subscribers with it. If the site is compromised, revoke the key from the
dashboard — sending stops immediately.

Is it multisite compatible?

Yes, with per-site settings: each site in the network uses its own public key,
because a Bildirim project maps to one site.