Claritee Design Importer

Claritee Design Importer allows you to seamlessly import your Claritee designs directly to your WordPress site. With full Elementor support and more page builders coming soon, you can transform your design workflow into a one-click publishing experience.

Features

• One-Click Publishing – Publish from Claritee directly to WordPress
• Elementor Support – Full Elementor page builder integration (more builders coming soon)
• Automatic Image Import – Images are automatically downloaded to your media library
• Secure API Keys – Simple and secure API key authentication
• Responsive – Maintains responsive breakpoints and settings
• Draft or Publish – Choose to publish directly or save as draft
• Usage Tracking – Monitor API key usage and last access time

How It Works

1. Install and activate the plugin
2. Generate an API key in WordPress Admin → Claritee → API Keys
3. Connect your WordPress site in Claritee settings
4. Design your page in Claritee
5. Click “Publish to WordPress” and your page is live!

Supported Page Builders

• Elementor (3.0.0 or higher)
• More coming soon!

Requirements

• WordPress 5.8 or higher
• PHP 7.4 or higher
• Elementor 3.0.0 or higher (for Elementor support)

Additional Information

API Endpoint

The plugin creates a REST API endpoint at:
/wp-json/claritee/v1/publish

Authentication

All requests must include the API key in the header:
X-Claritee-API-Key: your_api_key_here

Or alternatively:
Authorization: Bearer your_api_key_here

Support

For support and questions:
* Visit: help.claritee.io
* Email: [email protected]

Development

Developers can extend the plugin to support additional page builders by implementing the PageBuilderInterface. See the developer documentation for details.

Privacy Policy

This plugin does not collect any personal data. API keys are stored in your WordPress database and are used only for authentication when publishing from Claritee.

Automatic Installation

1. Log in to your WordPress admin panel
2. Navigate to Plugins → Add New
3. Search for “Claritee Design Importer”
4. Click Install Now and then Activate

Manual Installation

1. Download the plugin ZIP file
2. Go to Plugins → Add New → Upload Plugin
3. Upload the ZIP file and click Install Now
4. Click Activate Plugin

After Installation

1. Go to Claritee → API Keys in your WordPress admin
2. Click Generate New API Key
3. Copy the generated key (you won’t be able to see it again!)
4. In Claritee, go to Settings → Integrations → WordPress
5. Enter your site URL and paste the API key
6. Click Test Connection to verify
7. Start publishing!

Do I need a Claritee account?

Yes, you need a Claritee account to design and publish pages. Visit claritee.io to sign up.

Which page builders are supported?

Currently, we support Elementor (version 3.0.0 or higher). Support for additional page builders is coming soon.

Is HTTPS required?

While not strictly required for API keys, HTTPS is strongly recommended for security.

Can I have multiple API keys?

Yes! You can generate multiple API keys for different environments (production, staging, development).

What happens to my images?

All images are automatically downloaded from Claritee and imported into your WordPress media library. They are attached to the published page.

Can I update an existing page?

Currently, the plugin creates new pages. Update functionality is planned for a future release.

How do I revoke an API key?

Go to Claritee → API Keys, find the key you want to revoke, and click Revoke. The key will be immediately deactivated.

4.0.2

• Fix – Use wp_enqueue_script and wp_add_inline_script for JavaScript assets
• Fix – Use wp_add_inline_style for CSS assets instead of inline style tags
• Fix – Improve CSS content sanitization using wp_strip_all_tags
• Fix – Remove wp_set_current_user call, use direct capability checks instead
• Fix – Remove backup files from distribution

3.3.4

• Fix – Block Styles editor now shows current WordPress page title instead of stored title
• Fix – Deleted pages no longer appear in Block Styles dropdown
• Enhancement – Page dropdown always displays up-to-date page names even after renaming

3.3.3

• Enhancement – Each export now creates a unique folder with timestamp
• Enhancement – Multiple exports from same design no longer overwrite each other
• Enhancement – Each page has independent block files for isolated customization

3.3.2

• Fix – Strip timestamp suffixes from block names in all files (postContent, block.json, index.js, edit.js)
• Fix – Resolves “block not supported” error when re-exporting same design
• Enhancement – Normalizes block names across all exported files

3.3.1

• Fix – Strip timestamp suffixes from block names on re-exports
• Fix – Resolves “block not supported” error when re-exporting same design

3.3.0

• Major Simplification – Removed individual block CSS files, use only global styles.css per page
• Enhancement – Simplified CSS editor to single page selector (no block selector)
• Enhancement – Auto-submit on page selection for faster workflow
• Fix – Each export now gets unique timestamp in block names to prevent collisions
• UX – Clearer messaging: “All CSS for the selected page is edited in one global stylesheet”
• Performance – Reduced CSS file loading (one file per page instead of multiple)

3.2.2

• Fix – Removed heredoc syntax for WordPress.org compliance
• Compliance – Replaced heredoc with standard string concatenation

3.2.1

• Feature – Added Global Styles editor option to edit page-wide CSS (styles.css)
• Enhancement – Block dropdown now shows “Global Styles (All Blocks)” option at the top
• Enhancement – Users can now edit both individual block CSS and global CSS from the same interface
• Enhancement – Auto-generate default global CSS template with variables and comments

3.2.0

• Feature – Auto-generate default CSS for blocks with empty/missing style.css files
• Enhancement – CSS editor now shows starter CSS template for easy editing
• Enhancement – Default CSS includes WordPress constraint overrides
• Fix – Empty CSS editor issue resolved for older published pages

3.1.9

• Fix – Use page_id as key instead of pretotype_id to support multiple exports of same page
• Fix – Each WordPress page now has independent block registration
• Enhancement – Same Claritee design can be exported to multiple WordPress pages
• Enhancement – Added pretotype_id to stored data for reference

3.1.8

• Feature – Show page titles instead of export IDs in CSS editor
• Feature – Store page metadata with block data for better identification
• Enhancement – Backward compatible with old data format
• Enhancement – Changed “Export” label to “Page” for better UX
• Fix – CSS editor now properly handles both old and new data formats

3.1.7

• Fix – Individual block CSS files now properly enqueued on frontend
• Fix – Block styles now load in both frontend and Gutenberg editor
• Enhancement – Improved CSS loading for better style consistency

3.1.6

• Code quality – Fixed WordPress coding standards compliance issues
• Code quality – Added translator comments for sprintf placeholders
• Code quality – Improved CSS sanitization documentation
• Compliance – All WordPress.org validation errors resolved

3.1.5

• Feature – Added Block Styles editor page for customizing CSS
• Feature – CodeMirror-powered CSS editor with syntax highlighting
• Enhancement – Users can now edit block styles directly from WordPress admin
• Enhancement – Changes apply instantly to both editor and frontend
• UI – New “Block Styles” menu under Claritee admin

3.1.4

• Feature – Added editable images in Gutenberg editor (MediaUpload component)
• Feature – Added editor styles (editorStyle.css) for WYSIWYG preview
• Enhancement – Image hover effects with visual feedback
• Enhancement – Click images to change via WordPress Media Library
• Code – Added EditorStyleCssGenerator for editor-only styles

3.1.3

• Security hardening – Added comprehensive input validation and sanitization
• Security – Implemented protocol whitelist for image URLs (http/https only)
• Security – Added MIME type validation for file uploads
• Security – Enhanced filename sanitization to prevent directory traversal
• Security – Added JSON validation before writing block files
• Security – Added PHP file format validation
• Security – Enhanced type checking for all data structures
• Code quality – Removed all debug error_log() calls for production
• Compliance – Fixed readme.txt stable tag mismatch
• Documentation – Added comprehensive security documentation

1.1.4

• Fixed Claritee content wrapper structure – now extracts ‘content’ array from wrapper
• Added debug logging for content_data structure (when WP_DEBUG enabled)
• Properly handles Claritee’s {“title”,”type”,”version”,”content”:[]} format

1.1.3

• Fixed _elementor_page_settings – now stored as array instead of JSON string
• Fixed “Cannot access offset of type string on string” error in Elementor editor

1.1.2

• Fixed content_data conversion – properly handles string, object, and array formats
• Added validation to ensure Elementor data is always an array before saving
• Fixed “Argument #1 must be of type array, string given” error

1.1.1

• Removed duplicate slug validation – WordPress now auto-appends numbers (my-page-2, my-page-3, etc.)
• Removed 409 Conflict error response for duplicate slugs
• Simplified page creation workflow

1.1.0

• Improved HTTP status code handling for better API responses
• Changed builder availability errors from 400 to 422 (Unprocessable Entity)
• More RESTful error responses (201, 400, 401, 403, 409, 422, 500)
• Better error categorization for client applications

1.0.9

• Added page_builder parameter support for future multi-builder compatibility
• Enhanced health check endpoint to include supported builders list
• Improved error messages for unavailable or unsupported builders

1.0.8

• Fixed menu icon color – now pure white for better visibility
• Icon properly visible on dark WordPress admin menu

1.0.7

• Updated author information
• Stability improvements

1.0.6

• Fixed menu icon color to match WordPress admin theme
• Icon now properly changes color on hover and active states
• Better integration with WordPress menu styling

1.0.5

• Fixed menu icon flickering issue on page navigation
• Optimized icon loading using direct SVG URL instead of base64
• Added smooth opacity transitions for better UX

1.0.4

• Added Claritee logo as menu icon (replaces generic upload icon)
• Better visual branding in WordPress admin menu

1.0.3

• Updated Claritee app link to https://claritee.io/app
• Improved navigation instructions: “Your Project → Settings → WordPress”

1.0.2

• Updated setup instructions with link to Claritee
• Changed navigation path to Project → Settings → WordPress

1.0.1

• UI improvements: Better card layout in admin settings
• Minor CSS adjustments for improved readability

1.0.0

• Initial release
• Elementor page builder support
• Image import functionality
• API key authentication system
• WordPress admin settings page
• Usage tracking and monitoring
• REST API endpoint
• Health check endpoint
• Extensible architecture for future builders