claude-plugins/wordpress/skills/elementor/SKILL.md

name, description, author, version, user_invocable, tags, desk_task, allowed-tools, category, quality_score, updated

name	description	author	version	user_invocable	tags	desk_task	allowed-tools	category	quality_score	updated
elementor	Advanced development with Elementor Pro and Crocoblock ecosystem. Creates custom widgets, configures Theme Builder, develops with JetEngine, JetWooBuilder, optimizes performance and troubleshoots issues. Use when building Elementor sites, creating custom widgets, configuring theme templates, developing with Crocoblock, or when user mentions "elementor", "custom widget", "theme builder", "jetengine", "crocoblock", "jetwoobuilder", "page builder", "elementor pro".	Descomplicar® Crescimento Digital	1.1.0	true	wordpress elementor pagebuilder crocoblock jetengine widgets	1478	Read, Write, Edit, Bash, mcp__ssh-unified__ssh_execute, mcp__dify-kb__dify_kb_retrieve_segments	dev	75	2026-02-04T18:00:00Z

/elementor - Elementor Development

Desenvolvimento avançado com Elementor Pro e Crocoblock.

Quando Usar

• Criar widgets Elementor customizados
• Configurar Theme Builder
• Desenvolver com Crocoblock (JetEngine, JetWooBuilder)
• Optimizar performance Elementor
• Troubleshooting Elementor

Estrutura Custom Widget

<?php
/**
 * Custom Elementor Widget
 *
 * @author Descomplicar® Crescimento Digital
 * @link https://descomplicar.pt
 * @copyright 2026 Descomplicar®
 */

class Custom_Widget extends \Elementor\Widget_Base {

    public function get_name() {
        return 'custom-widget';
    }

    public function get_title() {
        return 'Custom Widget';
    }

    public function get_icon() {
        return 'eicon-code';
    }

    public function get_categories() {
        return ['general'];
    }

    protected function register_controls() {
        $this->start_controls_section(
            'content_section',
            [
                'label' => 'Content',
                'tab' => \Elementor\Controls_Manager::TAB_CONTENT,
            ]
        );

        $this->add_control(
            'title',
            [
                'label' => 'Title',
                'type' => \Elementor\Controls_Manager::TEXT,
                'default' => 'Title',
            ]
        );

        $this->end_controls_section();

        // Style controls
        $this->start_controls_section(
            'style_section',
            [
                'label' => 'Style',
                'tab' => \Elementor\Controls_Manager::TAB_STYLE,
            ]
        );

        $this->add_control(
            'title_color',
            [
                'label' => 'Color',
                'type' => \Elementor\Controls_Manager::COLOR,
                'selectors' => [
                    '{{WRAPPER}} .title' => 'color: {{VALUE}}',
                ],
            ]
        );

        $this->end_controls_section();
    }

    protected function render() {
        $settings = $this->get_settings_for_display();
        ?>
        <div class="custom-widget">
            <h2 class="title"><?php echo esc_html($settings['title']); ?></h2>
        </div>
        <?php
    }
}

Registar Widget

// functions.php ou plugin
add_action('elementor/widgets/register', function($widgets_manager) {
    require_once(__DIR__ . '/widgets/custom-widget.php');
    $widgets_manager->register(new \Custom_Widget());
});

Theme Builder

Header

Site Logo | Navigation Menu | Search | Cart Icon
Sticky: Yes | Transparent: Optional

Footer

4 Columns: About | Links | Contact | Social
Copyright row

Single Post

Featured Image
Title + Meta (Author, Date, Categories)
Content
Author Box
Related Posts

Archive

Title
Filters (JetSmartFilters)
Post Grid/List (JetEngine)
Pagination

Crocoblock Plugins

Plugin	Uso Principal
JetEngine	CPT, Meta Fields, Dynamic Content, Listings
JetElements	Widgets adicionais (Timeline, Progress Bar)
JetSmartFilters	Filtros AJAX para listings
JetWooBuilder	Templates WooCommerce avançados
JetPopup	Popups com triggers avançados
JetTabs	Tabs, Accordions, Toggle
JetFormBuilder	Forms com lógica condicional

JetEngine - Custom Post Type

// Via código (alternativa ao JetEngine UI)
add_action('init', function() {
    register_post_type('portfolio', [
        'labels' => [
            'name' => 'Portfolio',
            'singular_name' => 'Project'
        ],
        'public' => true,
        'has_archive' => true,
        'supports' => ['title', 'editor', 'thumbnail'],
        'show_in_rest' => true,
    ]);
});

// Meta boxes via JetEngine UI recomendado

Performance Tips

1. Lazy Load

// Activar lazy load para imagens
add_filter('wp_lazy_loading_enabled', '__return_true');

2. Desactivar Google Fonts (se usar fonts locais)

add_filter('elementor/frontend/print_google_fonts', '__return_false');

3. Limitar revisões

// wp-config.php
define('WP_POST_REVISIONS', 3);

4. Usar Flexbox Container

Preferir: Flexbox Container (moderno)
Evitar: Section > Column (legacy, mais pesado)

5. Minimizar Widgets

Regra: Máximo 50 widgets por página
Usar: CSS custom em vez de widgets simples

Breakpoints

Desktop: > 1024px
Tablet: 768-1024px
Mobile: < 768px

Configuração:
Elementor > Settings > Advanced > Breakpoints

Troubleshooting

Widget não aparece

# Limpar cache Elementor
wp elementor flush-css --allow-root

# Regenerar ficheiros CSS
wp elementor replace_urls --old=http --new=https --allow-root

Erro após update

# Rollback Elementor
Elementor > Tools > Version Control > Rollback

Performance lenta

1. Desactivar Google Fonts desnecessárias
2. Activar cache CSS minificado
3. Usar Flexbox Container
4. Lazy load imagens
5. Limitar widgets por página

Datasets Dify

Dataset	ID	Prioridade
Elementor	9c77d3e2-4d88-4a43-abff-d4e681267cc7	1
Crocoblock	bdf85c26-1824-4021-92d1-be20501b35ac	1
Crocooblock	139cdf67-afce-46ec-9ccd-2a06040e5b9d	1
Wordpress	9da0b2b9-5051-4b99-b9f6-20bf35067092	2

---

Versão: 1.0.0 | Autor: Descomplicar®