# Moodle Standards

> Apply Moodle coding standards (PSR-12 with exceptions) to PHP code. Validates style, naming conventions, PHPDoc, and type hints.

- Skill: `majiayu000/moodle-standards` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add majiayu000/moodle-standards`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/moodle-standards/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/moodle-standards

---


# Moodle Standards Skill

Apply Moodle coding standards (PSR-12 + exceptions) to PHP code.

## Trigger
- PHP files in Moodle plugin directories
- User requests code review or formatting
- New file creation in Moodle context

## Actions

### 1. Validate Code Style
Check code against Moodle standards:
- Line length (132 ideal, 180 max)
- Array syntax (`[]` only)
- `else if` not `elseif`
- No closing `?>` tag
- 4-space indentation

### 2. Fix Naming
Ensure proper naming:
- Variables: `$lowercase` (no underscores between words)
- Functions: `component_function_name()` (Frankenstyle)
- Classes: `lowercase_with_underscores`
- Constants: `COMPONENT_CONSTANT_NAME`

### 3. Add PHPDoc
Generate required documentation:
- File header with GPL
- `@package` tag (MANDATORY)
- `@param` with types
- `@return` description

### 4. Type Hints
Add mandatory type declarations:
- Parameter types
- Return types
- Nullable types (`?type`)

## Validation Command
```bash
vendor/bin/phpcs --standard=moodle path/to/file.php
```

## Quick Fixes

### Missing Package Tag
```php
/**
 * @package    mod_myplugin
 */
```

### Wrong Array Syntax
```php
// Before
$arr = array('a', 'b');
// After
$arr = ['a', 'b'];
```

### Wrong Else If
```php
// Before
} elseif ($x) {
// After
} else if ($x) {
```