Repository navigation
Expand file tree
/
Copy pathreadme.txt
More file actions
164 lines (106 loc) · 10 KB
/
Copy pathreadme.txt
File metadata and controls
164 lines (106 loc) · 10 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
=== Builder Shortcode Extras ===
Contributors: deckerweb
Tags: shortcodes, dynamic content, templates
Requires at least: 6.7
Requires PHP: 8.1
Tested up to: 7.1
Stable tag: 1.3.2
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html
Small dynamic helpers. Ready when you need them.
== Description ==
Copyright, dates, links and reusable content without custom PHP. Includes searchable help and a compact generator directly in WordPress.
= At a Glance =
- Searchable shortcode help under Tools → Builder Shortcode Extras.
- Nine generator cases: copyright, dates, links, embedding, title, excerpt, image and reading time.
- Native blocks, synced patterns and optional Elementor, Beaver, Astra and Genesis integrations.
- Local assets, informal/formal German translations and WordPress updates from GitHub.
= Installation and first steps =
1. Download the plugin ZIP from GitHub Releases.
2. Open Plugins → Add New → Upload Plugin and activate it.
3. Open Tools → Builder Shortcode Extras, choose a helper and copy its shortcode.
4. Paste it into a Shortcode block or supported builder field and check its output.
BSE saves no generator values and changes no content.
= Everyday helpers =
Insert copyright, dates, user information, post links, taxonomy terms, menus and comment forms where you need them. Most text helpers accept CSS classes and validated HTML wrappers. Content embedding respects access checks and prevents recursive references. Optional integrations require the corresponding builder or theme.
New helpers: `[bse-post-title]`, `[bse-post-excerpt words="30"]`, `[bse-post-image size="medium"]`, `[bse-reading-time wpm="200"]`. Select content with `post_id`; an omitted ID uses the current frontend item. Text helpers support `wrapper="none"` and `fallback`. Publication/modification dates optionally support `semantic="true"`. Generator content search sends search terms only to this WordPress website.
= Examples =
```text
[bse-copyright first="2019"]
[bse-post-date format="Y-m-d"]
[bse-post-modified-date label="Last updated: "]
[bse-post-link id="123" text="Read more"]
[bse-item-content id="123"]
```
= Updates and Library =
The deckerweb Updater 2.2.1 checks stable GitHub releases through the normal WordPress update system. It does not enable automatic updates. Embedded deckerweb Library 1.1.0 adds an optional catalog under Plugins → Add New → deckerweb. Online catalog retrieval is off by default. Installation and activation are separate decisions. GitHub sees the requesting IP address for metadata/package requests; BSE sends no telemetry, site address or user identifiers.
= Data and Multisite =
Activate BSE per website or network-wide. Content IDs belong to the current website. Site administrators use Tools → Builder Shortcode Extras; super administrators also have Network Settings → Builder Shortcode Extras. Library preferences are shared per network. BSE saves no settings. Deactivation preserves data; uninstall removes its update cache. Other installed hosts protect shared Library data. The final host clears temporary data and preserves preferences by default. Content and installed plugins are never removed.
== Installation ==
1. Download the plugin ZIP from GitHub Releases.
2. Open Plugins → Add New → Upload Plugin and activate it.
3. Open Tools → Builder Shortcode Extras, choose a helper and copy its shortcode.
4. Paste it into a Shortcode block or supported builder field and check its output.
BSE saves no generator values and changes no content.
== Frequently Asked Questions ==
= Do I need to configure the plugin? =
No. Open Tools → Builder Shortcode Extras to find or generate a shortcode. The page does not save settings.
= Where do I paste a shortcode? =
Use a WordPress Shortcode block or a builder field that explicitly supports shortcodes. Arbitrary text, URL and HTML fields do not necessarily execute them.
= What can the generator create? =
The generator creates copyright, publication/modification dates, post links, embedded content, titles, excerpts, featured images and reading time. Other helpers remain in the searchable catalog.
= Can I change the HTML and classes? =
Most text helpers accept wrapper, class, before and after. Multiple classes are supported. Unsafe or unsupported wrapper tags fall back to span. Text helpers support wrapper="none"; embedding, menus, comment forms and images retain their own markup. fallback supplies escaped text when no value is available.
= Are synced patterns supported with Classic Editor? =
The bse-wpblock helper is available whenever WordPress registers the wp_block post type. A legacy extra Blocks menu is no longer added.
= How do the new content helpers work? =
Use post_id to select readable content or omit it for the current frontend item. Excerpts use an explicit excerpt or stored text, with words between 1 and 500. Images use registered WordPress sizes and native responsive markup. Reading time counts stored prose without executing embedded shortcodes; wpm is limited to 50–1000. Builder-only markup and image-heavy articles can produce incomplete estimates.
= What does the content search send? =
After two characters the generator searches the current website through authenticated WordPress AJAX. A nonce and administrator capability are required. At most ten readable title/ID results are returned. No search terms are sent to GitHub or external services; manual IDs remain available when search fails.
[Complete FAQ by topic](https://github.com/deckerweb/builder-shortcode-extras/wiki/English#faq-by-topic).
== Screenshots ==
1. Plugin page with help and generator in English.
2. Plugin page with help and generator in German.
== Changelog ==
= 1.3.2 — 2026-10-22 =
- **Fixed:** Updates use the bundled updater even when another plugin loads an older copy first.
- **Misc:** Updated deckerweb Updater to 2.2.1; Library 1.1.0 and requirements remain unchanged.
= 1.3.1 — 2026-10-21 =
- **Improved:** Updated the shared plugin catalog and update integration.
- **Fixed:** Documentation dialogs remain closed until opened and retain native closing and document-link fallbacks.
- **Misc:** Bundles deckerweb Library 1.1.0 and Updater 2.2.0. Requires PHP 8.1 or later; WordPress 6.7 remains supported.
= 1.3.0 — 2026-10-10 =
- **New:** Title, excerpt, responsive featured image and estimated reading-time shortcodes.
- **New:** Optional wrapper-free text output, escaped fallback text and semantic date markup.
- **Improved:** Admin notices appear after the complete header; the product icon is shown only in the header.
- **Improved:** Nine generator cases with authenticated content search, clearer current-item context and preserved per-case drafts.
- **Improved:** Refreshed banners and rounded plugin icons with a consistent reusable-content design.
- **Fixed:** Link rel attributes now work without a target; navigation shortcodes honor the supplied container ID.
- **Misc:** Updated the embedded deckerweb Library to 0.9.0; existing shortcode features and minimum requirements remain unchanged.
= 1.2.1 — 2026-10-09 =
- **Improved:** Lower frontend overhead: update and catalog runtimes load only when needed; repeated site-modification queries share a request-local cache.
- **Improved:** Clearer local help, accessible changelog badges and consistent English, informal German and formal German documentation.
- **Fixed:** Version shortcodes no longer expose arbitrary installation constants; navigation shortcodes cannot invoke arbitrary PHP callbacks from content.
- **Fixed:** Private content links, dates and comment forms respect access permissions; labels, taxonomy separators and menu formatting are safely handled.
- **Fixed:** Network administration uses the appropriate permissions and Settings link; batch deinstallation preserves other plugins and shared Library ownership.
- **Fixed:** Update packages are checked against the offered version, plugin identity and actual WordPress/PHP requirements, including bulk updates.
- **Misc:** Bundles deckerweb Library 0.8.1 and Updater 2.1.0. Existing shortcode names, attributes, developer filters and optional integrations remain available.
- **Misc:** Updated bilingual readmes, FAQ, artwork and security reporting. Requirements remain WordPress 6.7+ and PHP 8.0+.
= 1.2.0 — 2026-10-01 =
- **New:** Searchable shortcode help with copy buttons and a local generator for copyright, publication date, modification date, post links and embedded content.
- **New:** Embedded deckerweb Plugin Library 0.2.0 and shared deckerweb GitHub Release Updater v2.
- **Improved:** Unified wrapper validation, multiple CSS classes, boolean attributes and escaped text boundaries; existing shortcode names, aliases and output filters remain.
- **Improved:** Native block rendering, builder-specific routing and guarded content embedding with direct/indirect recursion protection.
- **Improved:** Local changelog and documentation, with informal and formal German translations.
- **Fixed:** Corrected admin registration policy, persistent integration normalization and placeholder integration registration.
- **Fixed:** Publication dates honor explicit post IDs; slug links resolve correctly; missing IDs and unknown post-count statuses are handled.
- **Fixed:** Undefined version constants, database version lookup, user/fallback escaping, date labels, link text and tooltip escaping.
- **Fixed:** Site-updated dates use the WordPress timezone and return no false date when no published item exists.
- **Misc:** Requires WordPress 6.7+ and PHP 8.0+; the library requires PHP 8.0. No frontend assets are added by the helper UI.
- **Misc:** Retains Genesis and Beaver compatibility, removes the duplicate Astra loader, legacy Blocks menu and unrelated promotion/Core admin overrides.
= 1.1.0 — 2025-03-15 =
- **Improved:** Restored shortcode compatibility.
- **Misc:** Moved distribution away from WordPress.org and removed the old DDWlib recommendation installer.
- **Misc:** Removed the custom translation loader; retained packaged translations.
= 1.0.0 — 2019-09-10 =
- **New:** Initial plugin release with 25 general helpers and 5 integration shortcodes.