Changeset 3784049
- Timestamp:
- 11/04/2026 01:37:10 PM (5 hours ago)
- File:
-
- 1 edited
-
easy-custom-code/trunk/README.txt (modified) (4 diffs)
Legend:
- Unmodified
- Added
- Removed
-
easy-custom-code/trunk/README.txt
r3719871 r3784049 1 1 === Easy Custom Code (LESS/CSS/JS) - Live editing === 2 2 Contributors: yiannistaos, web357 3 Tags: css, javascript, less, customizer, web3573 Tags: css, javascript, less, customizer, custom code 4 4 Donate link: https://www.paypal.me/web357 5 5 Requires at least: 5.3 … … 10 10 License URI: http://www.gnu.org/licenses/gpl-3.0.html 11 11 12 Add custom LESS, CSS, and JavaScript—plus external stylesheets and scripts—via the WP Customizer. No child theme required.12 Add custom LESS, CSS, JavaScript and HTML from the WordPress Customizer. No child theme, and your code survives theme updates. 13 13 14 14 == Description == 15 The **[Easy Custom Code WordPress Plugin](https://www.web357.com/easy-custom-code-wordpress-plugin?utm_source=wp_ecc_repo&utm_medium=wp_listing_ecc&utm_campaign=wp_repo_link_ecc&utm_content=wp_repo_link_to_plugin_page_ecc)** lets you easily customize your WordPress website by adding your own **LESS**, **CSS**, and **JavaScript code** directly via the built-in WP Customizer. With this plugin, there's **no need for a child theme** or additional files. Simply insert your custom code, and it will be compiled into a minified CSS file for styles and a JavaScript file for scripts. 16 17 This lightweight plugin is designed for ease of use, providing a seamless and organized way to manage custom styling and scripts without affecting core theme files. 18 19 == VIDEO (How it works?) == 20 21 [youtube http://www.youtube.com/watch?v=Z9GE54_e6zE] 22 23 == FEATURES == 24 25 - Easily add custom LESS, CSS, and JavaScript to your site. 26 - Manage unlimited external stylesheets and scripts via a modal window. 27 - Control JavaScript placement (head or footer) for optimized performance. 28 - Insert custom HTML in key areas: 29 - Inside the `<head>` tag. 30 - Immediately after the opening `<body>` tag. 31 - Before the closing `</body>` tag. 32 33 == PRO FEATURES == 34 35 - **Minified CSS Output** – Option to enable automatic minification of compiled CSS. 36 - **Full-Screen Editor** – Maximize the code editor for a distraction-free coding experience. 15 16 The [Easy Custom Code WordPress plugin](https://www.web357.com/easy-custom-code-wordpress-plugin?utm_source=easycustomcodewp&utm_medium=wp_listing&utm_campaign=product_page&utm_content=readme_hero_product) adds **LESS, CSS, JavaScript and HTML editors to the WordPress Customizer**. 17 18 You want to change a colour, hide a button or add a tracking code. Editing the theme means your change is gone after the next theme update. With this plugin you write the code in the Customizer, preview it, and click **Publish**. The code is saved in its own files, so theme updates leave it alone. 19 20 Setup and every editor are explained in the [official documentation](https://docs.web357.com/easy-custom-code-less-css-js-wordpress-plugin/intro/?utm_source=easycustomcodewp&utm_medium=wp_listing&utm_campaign=docs&utm_content=readme_hero_docs). 21 22 👉 [See it on our demo site](https://demo-wordpress.web357.com/try-the-easy-custom-code-less-css-js-wordpress-plugin/?utm_source=easycustomcodewp&utm_medium=wp_listing&utm_campaign=demo&utm_content=readme_live_demo). 23 24 == How it works == 25 26 1. Go to **Appearance → Customize → Easy Custom Code**. 27 2. Write CSS or LESS, JavaScript, or HTML in the editor you need. The preview updates as you type. 28 3. Click **Publish**. Your styles are compiled into one CSS file and your scripts into one JS file. 29 30 [youtube https://www.youtube.com/watch?v=Z9GE54_e6zE] 31 32 == Free features == 33 34 - **CSS and LESS editor**: plain CSS works as it is; LESS adds variables, nesting and mixins. [CSS and LESS »](https://docs.web357.com/easy-custom-code-less-css-js-wordpress-plugin/customizer/css-and-less/?utm_source=easycustomcodewp&utm_medium=wp_listing&utm_campaign=docs&utm_content=readme_free_css) 35 - **JavaScript editor**: add JavaScript or jQuery without script tags. [JavaScript »](https://docs.web357.com/easy-custom-code-less-css-js-wordpress-plugin/customizer/javascript/?utm_source=easycustomcodewp&utm_medium=wp_listing&utm_campaign=docs&utm_content=readme_free_js) 36 - **Unlimited external stylesheets and scripts**: paste the URL of a library such as Bootstrap or Font Awesome and the plugin adds the tag for you. 37 - **JavaScript position**: load your scripts in the footer (default) or in the head. [Settings »](https://docs.web357.com/easy-custom-code-less-css-js-wordpress-plugin/settings/?utm_source=easycustomcodewp&utm_medium=wp_listing&utm_campaign=docs&utm_content=readme_free_settings) 38 - **Custom HTML in three places**: inside the head tag, right after the opening body tag, and before the closing body tag, for tracking codes, verification tags and widgets. [HTML code »](https://docs.web357.com/easy-custom-code-less-css-js-wordpress-plugin/customizer/html-code/?utm_source=easycustomcodewp&utm_medium=wp_listing&utm_campaign=docs&utm_content=readme_free_html) 39 - **Live preview**: see every change in the Customizer before you publish it. 40 - **Cache-friendly files**: compiled CSS and JS files get new names when they change, so caching plugins and CDNs pick up the new version. 41 42 == PRO features == 43 44 Upgrade to [Easy Custom Code PRO](https://www.web357.com/easy-custom-code-wordpress-plugin/pricing?utm_source=easycustomcodewp&utm_medium=wp_listing&utm_campaign=product_page&utm_content=readme_pro_upgrade) for a smaller stylesheet and more room to write. Plans cover 1, 3, 5 or unlimited sites and include 1 year of updates and support, with a 30-day money-back guarantee. 45 46 - **[Minified CSS](https://docs.web357.com/easy-custom-code-less-css-js-wordpress-plugin/settings/?utm_source=easycustomcodewp&utm_medium=wp_listing&utm_campaign=docs&utm_content=readme_pro_minify#minify-css)**: the compiled stylesheet is written without spaces and comments after each publish. 47 - **[Full-screen editor](https://docs.web357.com/easy-custom-code-less-css-js-wordpress-plugin/customizer/css-and-less/?utm_source=easycustomcodewp&utm_medium=wp_listing&utm_campaign=docs&utm_content=readme_pro_fullscreen#full-screen-editor)**: open any editor in a large window for long stylesheets and scripts. 37 48 38 49 == What is LESS? == 39 50 40 LESS is a CSS preprocessor that allows for variables, nested rules, mixins, and more, making your stylesheets more efficient and maintainable.51 LESS is a CSS preprocessor. It adds variables, nested rules and mixins, so your stylesheets are shorter and easier to change. 41 52 42 53 #### LESS code: … … 70 81 ` 71 82 72 For full LESS documentation, visit [lesscss.org](http://lesscss.org/). 73 74 == Demo == 75 76 [Try Demo](https://demo.web357.com/wordpress/easy-custom-code/wp-admin/) 77 ``` 78 Username: demo 79 Password: demo 80 ``` 83 For the full LESS documentation, visit [lesscss.org](https://lesscss.org/). 84 85 == Documentation == 86 87 - [Introduction](https://docs.web357.com/easy-custom-code-less-css-js-wordpress-plugin/intro/?utm_source=easycustomcodewp&utm_medium=wp_listing&utm_campaign=docs&utm_content=readme_docs_intro) 88 - [Installation](https://docs.web357.com/easy-custom-code-less-css-js-wordpress-plugin/getting-started/installation/?utm_source=easycustomcodewp&utm_medium=wp_listing&utm_campaign=docs&utm_content=readme_docs_install) 89 - [Accessing the settings](https://docs.web357.com/easy-custom-code-less-css-js-wordpress-plugin/getting-started/accessing-the-settings/?utm_source=easycustomcodewp&utm_medium=wp_listing&utm_campaign=docs&utm_content=readme_docs_access) 90 - [CSS and LESS](https://docs.web357.com/easy-custom-code-less-css-js-wordpress-plugin/customizer/css-and-less/?utm_source=easycustomcodewp&utm_medium=wp_listing&utm_campaign=docs&utm_content=readme_docs_css) 91 - [JavaScript](https://docs.web357.com/easy-custom-code-less-css-js-wordpress-plugin/customizer/javascript/?utm_source=easycustomcodewp&utm_medium=wp_listing&utm_campaign=docs&utm_content=readme_docs_js) 92 - [HTML code](https://docs.web357.com/easy-custom-code-less-css-js-wordpress-plugin/customizer/html-code/?utm_source=easycustomcodewp&utm_medium=wp_listing&utm_campaign=docs&utm_content=readme_docs_html) 93 - [Settings](https://docs.web357.com/easy-custom-code-less-css-js-wordpress-plugin/settings/?utm_source=easycustomcodewp&utm_medium=wp_listing&utm_campaign=docs&utm_content=readme_docs_settings) 94 - [FAQ](https://docs.web357.com/easy-custom-code-less-css-js-wordpress-plugin/faq/?utm_source=easycustomcodewp&utm_medium=wp_listing&utm_campaign=docs&utm_content=readme_docs_faq) 95 - [Get support](https://www.web357.com/support/?utm_source=easycustomcodewp&utm_medium=wp_listing&utm_campaign=support&utm_content=readme_support) 81 96 82 97 == Installation == 83 This plugin is simple to install: 98 99 **From the WordPress dashboard** 100 101 1. Go to **Plugins → Add New Plugin**. 102 2. Search for **Easy Custom Code** by Web357. 103 3. Click **Install Now**, then **Activate**. 104 4. Open **Appearance → Customize → Easy Custom Code**. 105 106 **Manual upload** 84 107 85 108 1. Download the `easy-custom-code.zip` file. 86 2. Extract the contents.87 3. Upload the `easy-custom-code` directory to `/wp-content/plugins/`.88 4. Navigate to the Plugins page in WordPress and activate the plugin. 89 5. Configure your settings under `Settings > Easy Custom Code`.109 2. Go to **Plugins → Add New Plugin → Upload Plugin**, choose the zip, and click **Install Now**. 110 3. Activate the plugin and open **Settings → Easy Custom Code** to choose the JavaScript position. 111 112 Step-by-step screenshots: [Installation guide](https://docs.web357.com/easy-custom-code-less-css-js-wordpress-plugin/getting-started/installation/?utm_source=easycustomcodewp&utm_medium=wp_listing&utm_campaign=docs&utm_content=readme_install_docs). 90 113 91 114 == Frequently Asked Questions == 92 115 116 = What is free, and what is PRO? = 117 Free: the CSS/LESS, JavaScript and HTML editors, unlimited external stylesheets and scripts, the JavaScript position setting, and live preview. PRO: minified CSS output, the full-screen editor, and 1 year of updates and support. [Compare plans »](https://www.web357.com/easy-custom-code-wordpress-plugin/pricing?utm_source=easycustomcodewp&utm_medium=wp_listing&utm_campaign=product_page&utm_content=readme_faq_free_pro) 118 93 119 = Why should I use Easy Custom Code instead of editing my theme's style.css? = 94 Editing theme files — or even a child theme — means your changes can break or disappear after a theme update. Easy Custom Code stores all your custom LESS, CSS, JavaScript, and HTML safely in the database and outputs them as separate, optimized files, so your customizations survive every theme or WordPress update.120 Editing theme files, or even a child theme, means your changes can break or disappear after a theme update. Easy Custom Code stores your custom LESS, CSS, JavaScript and HTML in the database and outputs them as separate files, so theme updates leave them alone. 95 121 96 122 = Do I need to know LESS to use this plugin? = 97 No. You can paste plain CSS into the LESS/CSS field and it w ill work exactly the same. LESS is optional and is only useful if you want extra features such as variables, nesting, and mixins for cleaner stylesheets.98 99 = Where will my custom JavaScript load —in the head or in the footer? =100 You choose. Use the JS placement option to load your script either inside the `<head>` (for example for tracking pixels or verification tags) or right before the closing `</body>` tag (recommended for most scripts, for better page performance).123 No. You can paste plain CSS into the LESS/CSS field and it works the same. LESS is optional and is useful when you want variables, nesting and mixins. 124 125 = Where will my custom JavaScript load, in the head or in the footer? = 126 You choose. Load it in the footer (recommended for most scripts) or inside the head, for example for verification tags. [Settings »](https://docs.web357.com/easy-custom-code-less-css-js-wordpress-plugin/settings/?utm_source=easycustomcodewp&utm_medium=wp_listing&utm_campaign=docs&utm_content=readme_faq_position) 101 127 102 128 = Can I add Google Analytics, Meta Pixel, Google Tag Manager, or chat widgets? = 103 Yes. Use the " Custom HTML in <head>", "After opening <body>", or "Before closing </body>" sections to paste any tracking code, verification meta tag, or third-party widget —without touching theme files.129 Yes. Use the "In head", "After body" or "Before closing body" sections to paste the tracking code, verification tag or widget, without touching theme files. 104 130 105 131 = Does the plugin minify the compiled CSS? = 106 Yes . The PRO version automatically minifies the compiled CSS for smaller file size and faster page loads. The free version compiles your LESS/CSS into a single cleanstylesheet.132 Yes, in PRO. Turn on **Minify CSS** in Settings. The free version compiles your LESS/CSS into one readable stylesheet. 107 133 108 134 = Will my custom code load on every page of the site? = 109 Yes. Styles and scripts a dded through the Customizer are loaded site-wide on the frontend, keeping your branding consistent across all posts, pages, and custom post types.135 Yes. Styles and scripts are loaded on every frontend page. For page-specific scripts, use the conditions of your tag manager. 110 136 111 137 = Will my custom CSS and JS be deleted if I uninstall the plugin? = 112 Yes. All custom LESS, CSS, JavaScript , and HTML added through this plugin will be removed during uninstall, including the compiled CSS file. Make sure to back up your code first if you plan to reuse it later.138 Yes. All custom LESS, CSS, JavaScript and HTML added through this plugin, including the compiled files, is removed on uninstall. Copy your code first if you plan to reuse it. 113 139 114 140 = Is Easy Custom Code compatible with caching and optimization plugins? = 115 Yes. Because the compiled CSS and JS are written to physical files with unique names, they work smoothly with popular caching plugins (e.g. WP Rocket, LiteSpeed Cache, W3 Total Cache) and CDNs. 141 Yes. The compiled CSS and JS are written to files with unique names, so they work with caching plugins such as WP Rocket, LiteSpeed Cache and W3 Total Cache, and with CDNs. 142 143 = Where is the full documentation? = 144 Start here: [Easy Custom Code docs](https://docs.web357.com/easy-custom-code-less-css-js-wordpress-plugin/intro/?utm_source=easycustomcodewp&utm_medium=wp_listing&utm_campaign=docs&utm_content=readme_faq_docs). For help, [contact support](https://www.web357.com/support/?utm_source=easycustomcodewp&utm_medium=wp_listing&utm_campaign=support&utm_content=readme_faq_support). 116 145 117 146 == Screenshots == … … 121 150 4. Add external scripts and choose their placement. 122 151 5. Insert custom HTML snippets in key sections (head, body open, body close). 123 6. Full-screen editor mode for an enhanced coding experience. 124 7. View and edit minified CSS for optimal performance. 125 8. Plugin settings panel for easy configuration. 152 6. The Maximize editor link under the CSS or LESS editor (PRO). 153 7. Full-screen editor mode for long stylesheets (PRO). 154 8. Minified CSS output (PRO). 155 9. Plugin settings: JavaScript position and Minify CSS. 156 157 == Source Code == 158 159 The PHP source of this plugin is readable in the distributed files. The bundled LESS compilers are third-party libraries: lessphp (`includes/libs/lessphp.php`, used to compile on publish) and less.js (`public/js/less.min.js`, used only for the live preview in the Customizer), whose source is at https://github.com/less/less.js. 160 161 == External Services == 162 163 The plugin does not send your data to Web357 or any other service. It only loads the external stylesheets and scripts whose URLs you add yourself; those files are requested by your visitors' browsers from the servers you chose. A LESS `@import` of a remote URL is fetched by your server when you publish. 126 164 127 165 == Changelog ==
Note:
See TracChangeset
for help on using the changeset viewer.
![(please configure the [header_logo] section in trac.ini)](/chrome/site/your_project_logo.png)