|
1 |
| -# WordPress Plugin |
| 1 | +# WordPress Plugin - PHP |
2 | 2 |
|
3 |
| -A simple WordPress plugin boilerplate for Admin related tasks. |
4 |
| - |
5 |
| -## Technologies |
6 |
| - |
7 |
| -- [**vue.js**](https://vuejs.org/) The Progressive JavaScript Framework. |
8 |
| -- [**Vite**](https://vitejs.dev/) Next Generation Frontend Tooling. |
9 |
| -- [**tailwindcss**](https://tailwindcss.com/) Rapidly build modern websites without ever leaving your HTML. |
10 |
| -- [**Notyf**](https://github.com/caroso1222/notyf) A minimalistic JavaScript library for toast notifications. |
| 3 | +This is a simple template (called a "boilerplate") to help you build your own WordPress plugin. You don't need to know about fancy tools to use it, but if you want, you can add extra things like **Alpine.js**, **Vue.js**, or other libraries to make it even cooler! |
11 | 4 |
|
12 | 5 | ### Features
|
13 | 6 |
|
14 |
| -- Check used [Technologies](#technologies) features. |
15 |
| -- It replaces all placeholder strings during plugin creation. |
16 |
| -- It generates independent styles for backend without any conflict with WordPress core and any plugin or themes. |
17 |
| -- It makes zip for test plugin throughout a team by one command. |
18 |
| -- You can manage your plugin license and support with this. N.B. You will need a management system. you can check out my [WordPress Plugin Management System](https://github.com/devkabir/wordpress-plugin-management-system) |
| 7 | +- It helps you change placeholder names when creating your plugin, so you don’t have to worry about replacing everything manually. |
| 8 | +- It keeps your plugin’s style separate from the rest of WordPress and other plugins, so it won’t mess anything up. |
| 9 | +- You can make a **ZIP** file of your plugin easily so you can share it with your friends or team with just one command. |
| 10 | +- If you want, you can manage plugin licenses and support. To do that, you will need a system. You can check out my [WordPress Plugin Management System](https://github.com/devkabir/wordpress-plugin-management-system). |
19 | 11 |
|
20 |
| -## Requirements |
| 12 | +## What You Need (Requirements) |
21 | 13 |
|
22 |
| -- **node.js** v18.8.0 |
23 |
| -- **npm** v8.18.0 |
24 |
| -- **PHP** v7.4 or higher |
25 |
| -- **VS Code extension** check recommendations. |
26 |
| -- **bash** Any bash script compatible terminal. You may use Git Bash for this. For **Laragon** Users, You have already all tools, just add to path. |
| 14 | +- **PHP** version 7.4 or higher (this is the programming language WordPress uses). |
| 15 | +- **VS Code** (this is a free program you can use to write your code). Make sure to check for any recommended extensions. |
| 16 | +- **Bash Terminal** (this helps you run commands). If you have **Git Bash** or **Laragon**, you're all set! |
27 | 17 |
|
28 |
| -## For Fresh Start |
| 18 | +## Getting Started (Fresh Start) |
29 | 19 |
|
30 |
| -- Dev version with dummy content |
| 20 | +To start making your own plugin, follow these steps: |
| 21 | + |
| 22 | +1. Open a **Bash** terminal (or **Git Bash**). |
| 23 | +2. Run this command (copy and paste it): |
31 | 24 |
|
32 | 25 | ```bash
|
33 |
| -composer create-project devkabir/wordpress-plugin:dev-only-admin <your-plugin-name> |
| 26 | +composer create-project devkabir/wordpress-plugin:dev-only-php <your-plugin-name> |
34 | 27 | ```
|
35 | 28 |
|
36 |
| -## Documentation |
| 29 | +3. Replace `<your-plugin-name>` with what you want to call your plugin. |
| 30 | +4. Hit **Enter** and let it do its magic! |
| 31 | +5. You’re ready to start creating something amazing for WordPress! |
| 32 | + |
| 33 | +Happy coding! |
37 | 34 |
|
38 |
| -- [How to install](https://github.com/devkabir/wordpress-plugin/wiki#how-to-install) |
39 |
| -- [Project Organization](https://github.com/devkabir/wordpress-plugin/wiki#project-organization) |
40 |
| -- Components |
41 |
| - - [List](https://github.com/devkabir/wordpress-plugin/wiki/DataList) |
42 |
| - - [Table](https://github.com/devkabir/wordpress-plugin/wiki/DataTable) |
| 35 | +## Build |
43 | 36 |
|
44 |
| -## Recommended Plugins |
45 | 37 |
|
46 |
| -- For nice error page, [WordPress Debugger](https://github.com/devkabir/wordpress-plugin-debugger) |
47 | 38 |
|
48 |
| -## For visual learners |
| 39 | +## Extra Plugins (Recommended) |
49 | 40 |
|
50 |
| -- How to start |
51 |
| - - [](https://www.youtube.com/watch?v=ZXu4Y2Wt3-k) |
52 |
| -- How to debug |
53 |
| - - [](https://www.youtube.com/watch?v=rdTug4q5tEM) |
| 41 | +If you want some extra tools to help with debugging (fixing errors), you can use [Zero Debugger](https://github.com/devkabir/0-debugger). |
0 commit comments