For-Code-AGZ Plugin

Why For-Code-AGZ?

• Looks professional: 20+ elegant highlight themes, auto dark/light mode.

• Reads better: line numbers, code wrapping, code folding, and focus line highlighting.

• Shares faster: one-click copy, optional download button, and filename/header labels.

• Scales easily: code tabs, diff view, and reusable presets for consistent styling.

• Loads only when needed: conditional assets keep your site speedy.

Key Features

• Gutenberg Block – Insert code blocks visually with live preview.

• Shortcode Support – [for_code lang="js" title="app.js"] … [/for_code]

• Page Builder Ready – Works smoothly inside Elementor/Divi/Beaver/Oxygen text widgets.

• Syntax Highlighting – 40+ languages (JS, TS, HTML, CSS/SCSS, PHP, Python, C/C++, Java, Go, Rust, SQL, Bash, YAML, Markdown, and more).

• Auto Language Detect (toggleable) + manual override.

• Themes & Appearance

  • 20+ built-in themes (light/dark) + OS color-scheme auto detect

  • Line numbers (toggle), line highlighting (e.g., 3,6-9)

  • Code block title, filename, badge (e.g., “PHP 8”, “Snippet”)

  • Adjustable font size, padding, border radius

• Interaction

  • Copy to clipboard with visual feedback

  • Code folding / collapse (start collapsed or expanded)

  • Wrap long lines or horizontal scroll

  • Optional download button (exports as .txt or original extension)

• Code Tabs

  • Multiple files in one block with tabs (e.g., index.html, style.css, app.js)

  • Individual language per tab, persistent active tab

• Diff / Compare Mode – Show added/removed lines for tutorials & changelogs.

• Accessibility (A11y)

  • Keyboard-navigable controls, ARIA labels, high-contrast theme options

  • Screen-reader friendly announcements on copy

• Performance

  • Loads assets only on pages with code blocks

  • No jQuery dependency; minified CSS/JS; compatible with caching/CDN

• Security

  • Proper sanitization & escaping; safe rendering of code

• Localization

  • Translation-ready .pot file; RTL support

• Developer Friendly

  • Hooks/filters for custom themes, languages, and toolbar actions

  • Export/import Presets for team consistency

Use Cases

• Dev & tech blogs, tutorial sites

• Product & API documentation

• Course/LMS content and knowledge bases

• Changelog & release notes with diff view

• SaaS onboarding guides with copy-ready snippets

How It Works (Quick Start)

1. Install & Activate the plugin like any other WordPress plugin.

2. In Gutenberg, add “For-Code-AGZ” block → paste your code → pick language & theme.

3. In Classic/Builders, use shortcode:

   [for_code lang="python" title="main.py" lines="1-2,5" linenumbers="true" copy="true"]
# Your code here
[/for_code]


4. Optional: Create a Preset (theme, line numbers, copy button, etc.) and reuse it site-wide.

Technical Details

• WordPress: 5.8–6.x

• PHP: 7.4–8.x

• Editors: Gutenberg, Classic Editor

• Builders: Elementor, Divi, Beaver Builder, Oxygen (via text/HTML widgets)

• Standards: WordPress Coding Standards, i18n ready, RTL ready

• Performance: Conditional asset loading, no jQuery, compatible with caching/minify plugins

• Security: Nonces for actions, strict sanitization/escaping

Settings & Customization

• Global defaults: theme, font size, padding, border radius, shadow

• Toggle features per block: copy, download, wrap, fold, line numbers

• Set default language, tab style, and auto-detect behavior

• Configure file labels (icon + filename) and block titles

• Presets to apply consistent design across the site

• Custom CSS field for advanced styling

SEO & Accessibility

• Clean, semantic HTML for crawlers

• No inline styles bloat; minimal DOM

• ARIA labels for controls (Copy, Expand/Collapse, Download)

• High-contrast theme and focus states

Included in Your Purchase ($69)

• Lifetime plugin updates

• 6 months of support via ticket/email (extendable on ThemeForest)

• Detailed online documentation & setup guide

• Sample presets and demo content

Frequently Asked Questions

Q: Will it slow down my site?
A: No. Assets load only on pages where you use For-Code-AGZ. No jQuery; files are minified.

Q: Does it work with Elementor/Divi/Oxygen?
A: Yes. Insert code via their text/HTML widgets or shortcodes; all features apply.

Q: Can I create code tabs?
A: Yes. Add multiple tabs per block, each with its own language and filename.

Q: Does it support dark mode automatically?
A: Yes. You can either force a theme or let it follow the visitor’s OS preference.

Q: Is multi-language (i18n) supported?
A: Yes. The plugin is translation-ready with a provided .pot file and supports RTL.

Q: Can I highlight or fold specific lines?
A: Yes. Use line highlight ranges (e.g., 2,5-8) and enable folding per section or whole block.

Q: What about security?
A: Code is output safely with proper sanitization and escaping.

Changelog

v1.0.0 — Initial Release

• Gutenberg block + shortcode

• 40+ languages, 20+ themes

• Copy/download buttons, line numbers, diff mode

• Code tabs, folding, presets, auto dark/light

• Conditional assets, zero jQuery

What’s in the Package

• Plugin ZIP file ready for upload

• Documentation (installation, usage, shortcodes, hooks/filters)

• Sample presets & demo JSON

Suggested Demo Links (replace with your URLs)

• Live Demo: your-domain.com/for-code-agz-demo

• Documentation: your-domain.com/docs/for-code-agz

• Changelog: your-domain.com/changelog/for-code-agz

Image/Preview Suggestions (for ThemeForest gallery)

1. Hero Banner: For-Code-AGZ — Beautiful Code Blocks for WordPress + price badge.

2. Feature Collage: Syntax themes, copy button, tabs, diff mode, dark/light.

3. Performance Slide: Conditional assets, zero jQuery, blazing fast.

4. Gutenberg UI: Block settings panel screenshot (theme, line numbers, copy).

5. Builders Slide: Elementor/Divi examples with shortcode in action.

6. Accessibility & SEO: ARIA, keyboard nav, semantic HTML callouts.

7. Use Cases: Blog, Docs, LMS, Changelog layouts.

8. Changelog & Support: Lifetime updates, 6-month support, version badge.