bueltge / wordpress-admin-style
Shows the WordPress admin styles on one page to help you to develop WordPress compliant
Fund package maintenance!
bueltge
bueltge.de/impressum/#hinweis
Installs: 16 285
Dependents: 1
Suggesters: 0
Security: 0
Stars: 979
Watchers: 56
Forks: 121
Open Issues: 2
Type:wordpress-plugin
pkg:composer/bueltge/wordpress-admin-style
Requires
- php: >5.2.4
README
Shows the WordPress admin styles on one page to help you to develop WordPress compliant
- List markup and examples for '2 Column Page Layout', Headers, Header Icons, Buttons, Tables, Admin Notices, Alternative Colours, Pagination, Form Elements, Form Helper Functions, Tabs, Default Admin Color Schemes
- WP Color Picker
- Helper Classes
- jQuery UI Examples
- Dashicons
- Genericons
Description
WordPress is developing fast - this also applies to the design of the backend. So it is important not to use your own styles in the admin area and use tags and classes of WordPress. This is the best way you can simplify your work as a developer, and you don't have to test the design with every update. Unfortunately, there are quite extensive opportunities in the backend to implement the requirements. Several different classes and HTML structures are used. To be able to look up something this simple, I have developed this small plugin, which tinkers in the development environment and quickly represents the necessary elements.
Also see the post about the idea and also the comments for a discussion.
Screenshots & history
Some notes for the differences in case of Icons
What are Genericons?
Genericons was a free, GPL-licensed icon font project by Automattic (the creators of WordPress.com and Jetpack). They were developed to provide simple, generic icons for blogs.
Where they were found: They were very frequently used in the standard themes (like Twenty Thirteen, Twenty Fourteen, Twenty Fifteen, or Twenty Sixteen) and in the Jetpack plugin.
The Misconception: Since these themes are shipped pre-installed with WordPress, it seemed to many users as if the icons were firmly anchored in the system. Technically, however, the files were located in the respective theme folder (/wp-content/themes/...) and not in the core system (/wp-includes/).
What is actually in Core?
The icons that are actually firmly integrated into the WordPress Core are called Dashicons.
Introduction: They were introduced with WordPress 3.8 (in 2013) when the admin design was completely overhauled (the "MP6" update). Purpose: Dashicons are the official icon font for the WordPress Admin Dashboard (backend). Availability: Developers can use these icons in the frontend as well, but they are primarily part of the wp-includes files.
Summery for the usage in the admin area
Use the Dashicons, because they are active in development, maintenance and inside the core.
Screenshots
The plugin is still active in usage and development since an early WordPress version, so you should see it on the screenshots from the different versions below.
- Admin Style in WordPress 3.1
- Admin Style in WordPress 3.4
- Admin Style in WordPress 3.6-alpha
- Admin Style in WordPress MP6 Design
- Dashicons in WordPress MP6 Design
- Genericons in WordPress 3.9-alpha
- Admin Style in WordPress 5.3
Installing
Manual
- Download the plugin as a ZIP file from GitHub.
- In your WordPress admin click Plugin -> Add New -> Upload Plugin.
- Upload the ZIP file.
- Activate the plugin.
Via Composer
The plugin is available as Composer package and can be installed via Composer from the root of your WordPress installation.
composer require bueltge/wordpress-admin-style
If you have changed the default directory structure or just want the plugin to a specific location, you can create a project from the Composer package.
composer create-project bueltge/wordpress-admin-style <optional-name>
Via Git
- Go to your Must Use folder
cd path git init .git remote add origin https://github.com/bueltge/wordpress-admin-style.gitgit fetch origingit checkout master- Check in the network plugin page, if it works
Automatic Udates
The plugin supports the GitHub Updater plugin for WordPress. The plugin enables automatic updates from this GitHub Repository. You will find all information about the how and why at the plugin wiki page.
Other Notes
Bugs, technical hints or contribute
Please give me feedback, contribute and file technical bugs on this GitHub Repo, use Issues.
License
Good news, this plugin is free for everyone! Since it's released under the GPLv2+, You can use it free of charge on your personal or commercial blog. But if you enjoy this plugin, you can thank me and leave a small donation for the time I've spent writing and supporting this plugin. And I really don't want to know how many hours of my life this plugin has already eaten ;)
Contact & Feedback
The plugin is designed and developed by me (Frank Bültge)
Please let me know if you like the plugin, or you hate it or whatever ... Please fork it, add an issue for ideas and bugs.
Disclaimer
I'm German, and my English might be gruesome here and there. So please be patient with me and let me know of typos or grammatical farts. Thanks
