Skip to content

Commit 30a3ae7

Browse files
committed
Version 1.3.0 of the plugin
1 parent c78f5a2 commit 30a3ae7

File tree

2 files changed

+112
-43
lines changed

2 files changed

+112
-43
lines changed

README.md

Lines changed: 45 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -40,17 +40,20 @@ Enjoying the plugin? Feel free to treat me to a cup of coffee ☕🙂 through th
4040
## Installation
4141

4242
#### **Quick Install – as Plugin**
43+
[![Download Plugin](https://raw.githubusercontent.com/deckerweb/snippets-quicknav/refs/heads/main/assets/button-download-plugin.png)](https://github.com/deckerweb/snippets-quicknav/releases/latest/download/snippets-quicknav.zip)
44+
4345
1. **Download ZIP:** [**snippets-quicknav.zip**](https://github.com/deckerweb/snippets-quicknav/releases/latest/download/snippets-quicknav.zip)
4446
2. Upload via WordPress Plugins > Add New > Upload Plugin
4547
3. Once activated, you’ll see the **Snippets** menu item in the Admin Bar.
4648

4749
#### **Alternative: Use as Code Snippet**
50+
[![Download Code Snippet](https://raw.githubusercontent.com/deckerweb/snippets-quicknav/refs/heads/main/assets/button-download-snippet.png)](https://github.com/deckerweb/snippets-quicknav/releases/latest/download/ddw-snippets-quicknav.code-snippets.json)
4851
1. Below, download the appropriate snippet version
49-
2. activate or deactivate in your snippets plugin
52+
2. Activate or deactivate in _Code Snippets_ plugin
5053

5154
[**Download .json**](https://github.com/deckerweb/snippets-quicknav/releases/latest/download/ddw-snippets-quicknav.code-snippets.json) version for _Code Snippets_ (free & Pro) just use the "Import" page.
5255

53-
--> Please decide for one of both alternatives!
56+
Please decide for one of both alternatives!
5457

5558
#### Minimum Requirements
5659
* WordPress version 6.7 or higher
@@ -60,7 +63,7 @@ Enjoying the plugin? Feel free to treat me to a cup of coffee ☕🙂 through th
6063

6164
#### Tested Compatibility
6265
- **Latest Code Snippets free & Pro**: 3.6.8 / 3.6.9 (including with Multisite)
63-
- **WordPress**: 6.7.2 / 6.8 Beta (including Multisite)
66+
- **WordPress**: 6.7.2 ... 6.8.1 (including Multisite)
6467
- **PHP**: 8.0 – 8.3
6568

6669
---
@@ -106,29 +109,30 @@ Just manually: Download the latest Snippet version (see above) and import it in
106109

107110
## Frequently Asked Questions
108111

109-
### How can I change / tweak things?
112+
### How can I change / tweak things?
110113
Please see here under [**Custom Tweaks via Constants**](#custom-tweaks-via-constants) what is possible!
111114

112-
### Why is this functionality not baked into Code Snippets itself?
115+
### Why is this functionality not baked into Code Snippets itself?
113116
I don't know. Not everything needs to be built-in. That's what plugins are for: those who _need_ this functionality can install and use them. Or better, [just use it as Code Snippet](#installation) in _Code Snippet_ itself. Done :-)
114117

115-
### Why did you create this plugin?
118+
### Why did you create this plugin?
116119
Because I needed (and wanted!) it myself for the sites I maintain. [Read the backstory here ...](#plugins-backstory)
117120

118-
### Why is this plugin not on wordpress.org plugin repository?
121+
### Why is this plugin not on wordpress.org plugin repository?
119122
Because the restrictions there for plugin authors are becoming more and more. It would be possible, yes, but I don't want that anymore. The same for limited support forums for plugin authors on .org. I have decided to leave this whole thing behind me.
120123

121124
---
122125

123126
## Custom Tweaks via Constants
124127

125-
### Default capability (aka permission)
128+
### Default capability (aka permission)
126129
The intended usage of this plugin is for Administrator users only. Therefore the default capability to see the new Admin Bar node is set to `activate_plugins`. You can change this via the constant `SNQN_VIEW_CAPABILITY` – define that via `wp-config.php` or via Code Snippet plugin:
127130
```
128131
define( 'SNQN_VIEW_CAPABILITY', 'activate_plugins' );
129132
```
130133

131-
### Restrict to defined user IDs only (since v1.2.0)
134+
135+
### Restrict to defined user IDs only (since v1.2.0)
132136
You can define an array of user IDs (can also be only _one_ ID) and that way restrict showing the Snippets Admin Bar item only for those users. Define that via `wp-config.php` or via Code Snippet plugin:
133137
```
134138
define( 'SNQN_ENABLED_USERS', [ 1, 500, 867 ] );
@@ -141,18 +145,29 @@ define( 'SNQN_ENABLED_USERS', [ 1 ] );
141145
```
142146
That way only you can see it, the other admins can't!
143147

144-
### Name of main menu item
148+
149+
### Position of main menu item (since v1.3.0)
150+
You can define an integer value to adjust the menu position of the main menu item. Define that via `wp-config.php` or via _Code Snippets_ plugin:
151+
```
152+
define( 'SNQN_MENU_POSITION', 81 );
153+
```
154+
This example will place it somewhere after the default "+ New" item. Note: the default value is `999` which puts the item quite on the middle or right side of the Admin Bar.
155+
156+
157+
### Name of main menu item
145158
The default is just "Snippets" – catchy and short. However, if you don't enjoy "Snippets" you can tweak that also via the constant `SNQN_NAME_IN_ADMINBAR` – define that also via `wp-config.php` or via Code Snippet plugin:
146159
```
147160
define( 'SNQN_NAME_IN_ADMINBAR', 'Codes' );
148161
```
149162

150-
### Snippets count – addition to main menu item:
163+
164+
### Snippets count – addition to main menu item:
151165
![With Counter -- Snippets QuickNav plugin](https://raw.githubusercontent.com/deckerweb/snippets-quicknav/master/assets-github/with-counter.png)
152166
```
153167
define( 'SNQN_COUNTER', 'yes' );
154168
```
155169

170+
156171
### Default icon of main menu item
157172
![Icon Alternatives -- Snippets QuickNav plugin](https://raw.githubusercontent.com/deckerweb/snippets-quicknav/master/assets-github/icon-alternatives.png)
158173
The "snip" icon – aka the scissor logo icon – is awesome and really historic. However, you can use two other alternatives: 1) The Code Snippets company logo (a bit red-ish / blue-ish) or 2) a more neutral "code" logo from Remix Icon (free and open source licensed!). You can also tweak that via a constant in `wp-config.php` or via Code Snippets plugin:
@@ -163,19 +178,22 @@ define( 'SNQN_ICON', 'red_blue' ); // Code Snippets company logo
163178
define( 'SNQN_ICON', 'remix' ); // code icon by Remix Icon
164179
```
165180

166-
### Disable code snippets library items
181+
182+
### Disable code snippets library items
167183
Removes the "Find Snippets" section
168184
```
169185
define( 'SNQN_DISABLE_LIBRARY', 'yes' );
170186
```
171187

172-
### Disable footer items (Links & About)
188+
189+
### Disable footer items (Links & About)
173190
Removes the "Links" & "About" sections
174191
```
175192
define( 'SNQN_DISABLE_FOOTER', 'yes' );
176193
```
177194

178-
### **Enable** "Expert Mode"
195+
196+
### **Enable** "Expert Mode"
179197
Nothing really fancy, just some additional links for coders:
180198
- _Site Health Info_ (WP Core)
181199
- Plugin: _DevKit Pro_ by DPlugins
@@ -187,7 +205,8 @@ define( 'SNQN_EXPERT_MODE', TRUE );
187205
```
188206
Note: Support for _some_ additional stuff in that mode may come in future.
189207

190-
### **Fair Play:** Enable "free CS free" – to remove some promo stuff ...
208+
209+
### **Fair Play:** Enable "free CS free" – to remove some promo stuff ...
191210
If you want the Pro promotions go away, use the following snippet ... or just purchase the Pro version to support the developers. Thank you in advance! (And thanks to the Code Snippets team for making this awesome tool for us site builders and developers!)
192211
```
193212
define( 'SNQN_FREE_CS_FREE', 'yes' );
@@ -202,15 +221,22 @@ define( 'SNQN_FREE_CS_FREE', 'yes' );
202221

203222
**The Releases**
204223

205-
### 🎉 v1.2.0 – 2025-04-05
224+
### 🎉 v1.3.0 – 2025-05-09
225+
* New: Adjust the menu position of main item in the Admin Bar _(new custom tweak)_
226+
* Improve: Internal code enhancements
227+
* Update: `.pot` file, plus packaged German translations
228+
229+
230+
### 🎉 v1.2.0 – 2025-04-05
206231
* New: Optionally only enable for defined user IDs _(new custom tweak)_
207232
* New: Installable and updateable via [Git Updater plugin](https://git-updater.com/)
208233
* Improved: Admin Bar CSS for Block / Site Editor fullscreen mode
209234
* Fix: PHP warning on frontend
210235
* Fix: Minor styling issues for top-level item
211236
* Update: `.pot` file, plus packaged German translations, now including new `l10n.php` files!
212237

213-
### 🎉 v1.1.0 – 2025-03-25
238+
239+
### 🎉 v1.1.0 – 2025-03-25
214240
* New: Show Admin Bar also in Block Editor full screen mode
215241
* New: Support for _DevKit Pro_ plugin by DPlugins
216242
* New: Support for _System Dashboard_ plugin by Bowo
@@ -220,7 +246,8 @@ define( 'SNQN_FREE_CS_FREE', 'yes' );
220246
* Plugin: Add meta links on WP Plugins page
221247
* Update: `.pot` file, plus packaged German translations
222248

223-
### 🎉 v1.0.0 – 2025-03-21
249+
250+
### 🎉 v1.0.0 – 2025-03-21
224251
* Initial release
225252
* Includes support for _Code Snippets_ **free** AND **Pro** version
226253
* Includes support for WordPress Multisite installs and respects Code Snippets free behavior (and settings) in there

0 commit comments

Comments
 (0)