// NEVER
```
**All styles MUST be in SCSS files:**
- Components: `assets/scss/components/_component-name.scss`
- Pages: `assets/scss/pages/_page-name.scss`
**For dynamic values, use data attributes + CSS:**
```php
// CORRECT - data attribute in HTML
// CORRECT - CSS handles the calculation
.presszone-forum-nested[data-indent="1"] { margin-left: 12px; }
.presszone-forum-nested[data-indent="2"] { margin-left: 24px; }
```
### Accessibility Rules - MANDATORY
#### Semantic HTML Structure
```php
// ALWAYS use appropriate semantic elements
```
#### ARIA Labels and Roles
```php
// ALWAYS add ARIA labels to interactive elements
// ALWAYS add roles to custom elements
```
#### Keyboard Navigation
```php
// ALWAYS ensure keyboard accessibility
// NEVER use javascript:void(0) - use buttons instead
```
#### Screen Reader Support
```php
// ALWAYS provide text alternatives for visual indicators
// ALWAYS use proper heading hierarchy
```
### Data Protection & Privacy
#### Personal Data Handling
```php
// ALWAYS anonymize personal data in logs
error_log('User action: user_id=' . $user_id . ', action=delete_post'); // OK - ID only
error_log('User action: ' . $user_email . ' deleted post'); // FORBIDDEN - contains PII
// ALWAYS respect privacy settings
if (get_user_meta($user_id, 'presszone_forum_hide_email', true)) {
$email = __('Hidden', 'forum-press-zone');
} else {
$email = esc_html($user->user_email);
}
```
#### GDPR Compliance
```php
// ALWAYS provide data export capability
function export_user_forum_data($user_id) {
$data = [];
// Posts
$posts = $wpdb->get_results($wpdb->prepare(
"SELECT post_id, message, post_date FROM {$table} WHERE user_id = %d",
$user_id
));
foreach ($posts as $post) {
$data['posts'][] = [
'id' => $post->post_id,
'content' => $post->message,
'date' => $post->post_date
];
}
return $data;
}
// ALWAYS provide data deletion capability
function delete_user_forum_data($user_id) {
// Soft delete posts
$wpdb->update(
$table,
[
'is_soft_deleted' => 1,
'deleted_at' => current_time('mysql'),
'deleted_by' => $user_id
],
['user_id' => $user_id],
['%d', '%s', '%d'],
['%d']
);
}
```
### Performance & Caching Rules
#### Database Query Optimization
```php
// ALWAYS limit query results
$posts = $wpdb->get_results(
$wpdb->prepare(
"SELECT * FROM {$table} WHERE thread_id = %d LIMIT %d OFFSET %d",
$thread_id,
$per_page,
$offset
)
);
// ALWAYS use indexes in WHERE clauses
// Good: WHERE thread_id = %d (indexed)
// Bad: WHERE YEAR(post_date) = %d (can't use index)
```
#### Cache Integration
```php
// ALWAYS check cache first
$cache_key = "thread_{$thread_id}_posts";
$posts = wp_cache_get($cache_key, 'presszone_forum');
if (false === $posts) {
$posts = $wpdb->get_results(/* expensive query */);
wp_cache_set($cache_key, $posts, 'presszone_forum', 3600);
}
```
### Error Handling & Logging
#### User-Friendly Error Messages
```php
// ALWAYS provide helpful error messages
if (!$thread) {
status_header(404);
echo '
';
echo '
💭';
echo '
' . esc_html__('Thread Not Found', 'forum-press-zone') . '
';
echo '
' . esc_html__('The thread you are looking for does not exist or has been removed.', 'forum-press-zone') . '
';
echo '
';
return;
}
```
#### Graceful Degradation
```php
// ALWAYS provide fallbacks for failed operations
try {
$posts = $query->getNestedPosts($thread_id);
} catch (Exception $e) {
error_log('Forum query failed: ' . $e->getMessage());
// Fallback to simple list
$posts = $query->getSimplePosts($thread_id);
if (empty($posts)) {
echo '
';
echo '
' . esc_html__('Unable to load posts at this time. Please try again later.', 'forum-press-zone') . '
';
echo '
';
return;
}
}
```
### Translation & Internationalization
#### Text Domain Consistency
```php
// ALWAYS use 'forum-press-zone' text domain
__('Hello', 'forum-press-zone') // CORRECT
esc_html__('Hello', 'forum-press-zone') // CORRECT
_e('Hello', 'forum-press-zone') // CORRECT
// FORBIDDEN
__('Hello') // Missing domain
__('Hello', 'presszone-forum') // Wrong domain
```
#### Context and Comments
```php
// ALWAYS provide translator context for ambiguous terms
_x('Post', 'noun: forum post', 'forum-press-zone');
_x('Post', 'verb: to post', 'forum-press-zone');
// ALWAYS add translator comments for placeholders
/* translators: %1$s: user name, %2$s: time ago */
printf(
esc_html__('Posted by %1$s %2$s ago', 'forum-press-zone'),
esc_html($author_name),
esc_html($time_ago)
);
```
#### Pluralization
```php
// ALWAYS handle pluralization correctly
$message = sprintf(
_n(
'%d reply',
'%d replies',
$reply_count,
'forum-press-zone'
),
number_format_i18n($reply_count)
);
```
### Testing Requirements
#### Template Testing
```php
// ALWAYS test template rendering
class TestTemplates extends WP_UnitTestCase {
public function test_thread_template_renders_without_errors() {
$thread_id = $this->factory->post->create();
ob_start();
include PRESSZONE_FORUM_PATH . 'templates/presszone/single-thread.php';
$output = ob_get_clean();
$this->assertNotEmpty($output);
$this->assertStringContains('presszone-forum-thread', $output);
}
}
```
#### Security Testing
```php
// ALWAYS test XSS prevention
public function test_user_input_is_escaped() {
$malicious_input = '';
ob_start();
echo esc_html($malicious_input);
$output = ob_get_clean();
$this->assertStringNotContains('