Przejdź do treści
Biblioteka skilli
Programowanie · Budowanie i kod

woo-plugin-dev

/woo-plugin-dev

Tworzy rozszerzenia i wtyczki WooCommerce: struktura plików, główny plik wtyczki, hooki aktywacji i dezaktywacji, własne tabele bazy, autoloading i API wtyczek WordPress.

Licencja
MIT
Ostatnia zmiana repozytorium
14.09.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
1
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
4
Przestarzałość

Brak sygnałów. Repozytorium zmienione 14.09.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Tworzy rozszerzenia i wtyczki WooCommerce: struktura plików, główny plik wtyczki, hooki aktywacji i dezaktywacji, własne tabele bazy, autoloading i API wtyczek WordPress.

Oryginalny opis (EN)

Create WooCommerce extensions/plugins — file structure, main plugin file, activation/deactivation hooks, custom database tables, autoloading, and WordPress plugin API. Use when building new WooCommerce extensions or structuring plugin code.

Jak działa

  1. Before writing code
  2. Main Plugin File
  3. Activation & Deactivation
  4. Custom Database Tables
  5. Autoloading
  6. Plugin Architecture Patterns
  7. Coding Standards
  8. Best Practices
Sekcje z nagłówków SKILL.md, w oryginale · 141 linii, 584 słów
Podgląd SKILL.md
---
name: woo-plugin-dev
description: Create WooCommerce extensions/plugins — file structure, main plugin file, activation/deactivation hooks, custom database tables, autoloading, and WordPress plugin API. Use when building new WooCommerce extensions or structuring plugin code.
allowed-tools: Read, Write, Edit, Bash, Grep, Glob, WebSearch, WebFetch
---

# WooCommerce Extension / Plugin Development

## Before writing code

**Fetch live docs**:
1. Fetch `https://developer.wordpress.org/plugins/` for WordPress Plugin Handbook
2. Fetch `https://developer.woocommerce.com/docs/extension-guidelines/` for WooCommerce extension guidelines
3. Web-search `site:developer.woocommerce.com extension development best practices` for current patterns

## Main Plugin File

### Required Headers

```php
<?php
/**
 * Plugin Name: My WooCommerce Extension
 * Plugin URI:  https://example.com/my-extension
 * Description: A WooCommerce extension that does X.
 * Version:     1.0.0
 * Author:      Your Name
 * Author URI:  https://example.com
 * License:     GPL-2.0-or-later
 * Text Domain: my-woo-extension
 * Domain Path: /languages
 * Requires at least: 6.4
 * Requires PHP: 8.0
 * Requires Plugins: woocommerce
 * WC requires at least: 8.0
 * WC tested up to: 9.5
 */
```

### Guarding Against Direct Access

Every PHP file starts with: `defined( 'ABSPATH' ) || exit;`

### WooCommerce Dependency Check

Before initializing, verify WooCommerce is active:
- Check `class_exists( 'WooCommerce' )` in a `plugins_loaded` hook
- Or use `Requires Plugins: woocommerce` header (WordPress 6.5+)

## Activation & Deactivation

### Activation Hook

`register_activation_hook( __FILE__, 'my_plugin_activate' )` — runs on first activation:
- Create custom database tables (via `dbDelta()`)
- Add default options (`add_option()`)
- Schedule recurring actions (Action Scheduler)
- Flush rewrite rules if registering custom post types

### Deactivation Hook

`register_deactivation_hook( __FILE__, 'my_plugin_deactivate' )` — runs when deactivated:
- Unschedule cron/Action Scheduler events
- Flush rewrite rules
- Do NOT delete data (that's for uninstall)

### Uninstall

Use `uninstall.php` (preferred) or `register_uninstall_hook()`:
- Delete custom options, transients, custom tables
- Clean up user meta, post meta
- Only runs when user explicitly deletes the plugin

## Custom Database Tables

### Using `$wpdb` and `dbDelta()`

Create tables on activation:
- Use `$wpdb->prefix` for table name prefix
- Define schema with `dbDelta()` from `wp-admin/includes/upgrade.php`
- `dbDelta()` is idempotent — handles CREATE and ALTER
- Store DB version in an option to manage schema upgrades

### Table Naming

Convention: `{$wpdb->prefix}wc_my_extension_tablename`

## Autoloading

### Composer PSR-4

Standard approach for namespaced classes:
- Configure `autoload.psr-4` in `composer.json`
- `require __DIR__ . '/vendor/autoload.php'` in main plugin file
- Namespace convention: `MyVendor\MyExtension\`

### WordPress File-Based

Legacy approach: `require_once` individual files in an `includes/` directory. Still common in WooCommerce core.

## Plugin Architecture Patterns

### Singleton Main Class

Common WooCommerce extension pattern:
- Private constructor
- Static `instance()` method
- `init()` method that registers all hooks
- Accessed via global function (e.g., `my_extension()`)

### Service Container (Advanced)

For larger extensions, use a lightweight DI container or service provider pattern with constructor injection.

### Feature Flags

Use WooCommerce's `FeaturesUtil` to declare compatibility:
- `custom_order_tables` — HPOS support
- `cart_checkout_blocks` — Block checkout support

## Coding Standards

### WordPress Coding Standards (WPCS)

- **Tabs** for indentation (not spaces)
- **Yoda conditions**: `if ( 'value' === $var )`
- **Braces** on same line for functions/control structures
- **Spaces** inside parentheses: `if ( $condition )`
- **Prefix** all globals: functions, classes, hooks, options, constants
- **Escaping** all output: `esc_html()`, `esc_attr()`, `esc_url()`, `wp_kses()`
- **Sanitizing** all input: `sanitize_text_field()`, `absint()`, `wp_unslash()`
- **Nonces** for all form submissions and AJAX

## Best Practices

- Use `Requires Plugins: woocommerce` header (WordPress 6.5+)
- Declare HPOS compatibility in every extension
- Use Composer autoloading for new code
- Prefix everything to avoid naming collisions
- Internationalize all user-facing strings with `__()`, `_e()`, `esc_html__()`
- Load text domain via `load_plugin_textdomain()`
- Use WordPress built-in functions over raw PHP equivalents (`wp_remote_get()` vs `curl`)
- Never modify WooCommerce core files — always use hooks

Fetch the WordPress Plugin Handbook and WooCommerce extension guidelines for exact patterns and current requirements before implementing.

Wersje

W bazie nie ma innych skilli o nazwie woo-plugin-dev.

Migawka bazy z 13.11.2026 · wersja paczki 2f4eed638374 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100woocommerce-plugin-dev
    Prowadzi tworzenie wtyczek WooCommerce zgodnie ze standardami kodowania WordPress i WooCommerce, dobrymi praktykami bezpieczeństwa i testami end-to-end dla każdego pliku.
  • 100wp-plugin-scaffold
    Tworzy szkielet nowej wtyczki WordPress z autoloadingiem PSR-4, obsługą aktywacji i dezinstalacji, tłumaczeniami i testami.
  • 90woo-hooks-filters
    Opisuje system hooków WordPress dla WooCommerce: akcje, filtry, priorytety, hooki specyficzne dla WooCommerce i wzorce rozszerzalności.
  • 100woo-testing
    Testuje rozszerzenia WooCommerce: testy jednostkowe i integracyjne PHPUnit, zestaw testów WP, pomocnicze klasy WooCommerce, E2E z Playwright i szkielety testów WP-CLI.
  • 100wordpress-wp-plugin-development
    Tworzy wtyczki WordPress: hooki, aktywację i dezinstalację, panel administracyjny, zadania cron i pakowanie wydania.
  • 91wp-plugin-development
    Przegląda architekturę wtyczek WordPressa i sprawdza zgodność ze standardami WordPress.org przed zgłoszeniem, w tym typy wpisów, taksonomie i hooki.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.