After executing the above command you can see something like:
C:\Users\USER\AppData\Roaming\Composer
λ composer require --dev phpcompatibility/phpcompatibility-wp:*
./composer.json has been updated
Loading composer repositories with package information
Updating dependencies (including require-dev)
Package operations: 2 installs, 0 updates, 0 removals
- Installing phpcompatibility/phpcompatibility-paragonie (1.3.0): Loading from cache
- Installing phpcompatibility/phpcompatibility-wp (2.1.0): Loading from cache
phpcompatibility/phpcompatibility-paragonie suggests installing roave/security-advisories (dev-master || Helps prevent installing dependencies with known security issues.)
phpcompatibility/phpcompatibility-wp suggests installing roave/security-advisories (dev-master || Helps prevent installing dependencies with known security issues.)
Writing lock file
Generating autoload files
PHP CodeSniffer Config installed_paths set to ../../phpcompatibility/php-compatibility,../../phpcompatibility/phpcompatibility-paragonie,../../phpcompatibility/phpcompatibility-wp,../../wp-coding-standards/wpcs
And then
composer install
After executing the above command you can see something like below:
C:\Users\USER\AppData\Roaming\Composer
λ composer install
Loading composer repositories with package information
Installing dependencies (including require-dev) from lock file
Nothing to install or update
Generating autoload files
PHP CodeSniffer Config installed_paths set to ../../phpcompatibility/phpcompatibility-paragonie,../../phpcompatibility/phpcompatibility-wp,../../wp-coding-standards/wpcs,../../phpcompatibility/php-compatibility
Great! you have successfully installed the PHPCompatibilityWP on your system.
How to confirm the PHPCompatibilityWP is installed?
To confirm the PHPCompatibilityWP is successfully installed on your system.
Use the same command which we have recently used that is phpcs -i.
E.g.
phpcs -i
After using it you can see the message something lie below:
The installed coding standards are MySource, PEAR, PSR1, PSR12, PSR2, Squiz, Zend, PHPCompatibilityParagonieRandomCompat, PHPCompatibilityParagonieSodiumCompat, PHPCompatibilityWP, WordPress, WordPress-Core, Wor
dPress-Docs, WordPress-Extra and PHPCompatibility
Now you can see the coding standard is now installed on your system.
I’m pleased to announce the launch of my new website! After 5 years of casual blogging, I am excited to officially announce the launch on 11 November 2019.
WordPress provides various types of plans which are:
Personal
Best for Personal Use: Boost your website with a custom domain name, and remove all WordPress.com advertising. Get access to high-quality email and live chat support.
Best for Entrepreneurs & Freelancers: Build a unique website with advanced design tools, CSS editing, lots of space for audio and video, Google Analytics support, and the ability to monetize your site with ads.
Best for Small Business: Power your business website with custom plugins and themes, unlimited premium and business theme templates, 200 GB storage, and the ability to remove WordPress.com branding.
After setup the PHP unit test on your Windows operating system maybe you get below error:
PHP Warning: require_once(/tmp/wordpress//wp-includes/class-phpmailer.php): failed to open stream: No such file or directory in C:\Users\MaheshW\AppData\Local\Temp\wordpress-tests-lib\includes\mock-mailer.php o
n line 2
...
...
Warning: require_once(/tmp/wordpress//wp-includes/class-phpmailer.php): failed to open stream: No such file or directory in C:\Users\MaheshW\AppData\Local\Temp\wordpress-tests-lib\includes\mock-mailer.php on lin
e 2
...
...
PHP Fatal error: require_once(): Failed opening required '/tmp/wordpress//wp-includes/class-phpmailer.php' (include_path='C:\xampp\php\PEAR') in C:\Users\MaheshW\AppData\Local\Temp\wordpress-tests-lib\includes\
mock-mailer.php on line 2
...
...
Fatal error: require_once(): Failed opening required '/tmp/wordpress//wp-includes/class-phpmailer.php' (include_path='C:\xampp\php\PEAR') in C:\Users\MaheshW\AppData\Local\Temp\wordpress-tests-lib\includes\mock-
mailer.php on line 2
...
...
In file C:\Users\MaheshW\AppData\Local\Temp\wordpress-tests-lib\wp-tests-config.php line 7 has code:
Before writing about how to create a website screenshot of website with CLI command, I think, I need to share some background.
Recently, I was working on some project in which I need to set 1000+ web page screenshots and resize them and set as a featured featured image for the post.
In this article I’ll just share how to capture the website screenshot with the CLI command. I’ll create another article to share how I was resize the screenshot and set the featured images in future articles.
Research About the Right Tool
I have research about this and found some below tools.
After some research, I have tried all of the above tools and finally select the capture-website-cli because of it fulfill all my requirement and also create better screenshots.
After executing the above command below screenshot is generated.
In above screenshot the string Mahesh Waghmare and This Screenshot is generated with 'capture-website-cli'. And also the string "Mahesh Waghmare" and this paragraph both are also injected with the JavaScript while creating https://wordpress.org/ web page screenshot.
Both are added though JS by injecting it with custom JS file while creating screenshot.
In above command the parameter --script is used. In which the script.js is set. And in this JS file I have write the below code:
Additional Parameters
Don’t forget try below parameters too. These are interesting.
--width Page width [default: 1280]
--height Page height [default: 800]
--type Image type: png|jpeg [default: png]
--quality Image quality: 0…1 (Only for JPEG) [default: 1]
--scale-factor Scale the webpage n times [default: 2]
--list-devices Output a list of supported devices to emulate
--emulate-device Capture as if it were captured on the given device
--full-page Capture the full scrollable page, not just the viewport
--no-default-background Make the default background transparent
--timeout Seconds before giving up trying to load the page. Specify 0 to disable. [default: 60]
--delay Seconds to wait after the page finished loading before capturing the screenshot [default: 0]
--wait-for-element Wait for a DOM element matching the CSS selector to appear in the page and to be visible before capturing the screenshot
--element Capture the DOM element matching the CSS selector. It will wait for the element to appear in the page and to be visible.
--hide-elements Hide DOM elements matching the CSS selector (Can be set multiple times)
--remove-elements Remove DOM elements matching the CSS selector (Can be set multiple times)
--click-element Click the DOM element matching the CSS selector
--scroll-to-element Scroll to the DOM element matching the CSS selector
--disable-animations Disable CSS animations and transitions [default: false]
--module Inject a JavaScript module into the page. Can be inline code, absolute URL, and local file path with .js extension. (Can be set multiple times)
--script Same as --module, but instead injects the code as a classic script
--style Inject CSS styles into the page. Can be inline code, absolute URL, and local file path with .css extension. (Can be set multiple times)
--header Set a custom HTTP header (Can be set multiple times)
--user-agent Set the user agent
--cookie Set a cookie (Can be set multiple times)
--authentication Credentials for HTTP authentication
--debug Show the browser window to see what it’s doing
--launch-options Puppeteer launch options as JSON
--overwrite Overwrite the destination file if it exists
Hope you enjoy this article. Try it yourself and let me know for any question. Some useful link:
Example 2: In below example I’m translating ShortcodeHub plugin.
E.g. To download the plugin .po files Im using command wp wpi18n download_plugin_po shortcodehub --lang=mr
D:\xampp\htdocs\wpi18n\wp-content\plugins\wp-i18n (master)
λ wp wpi18n download_plugin_po shortcodehub --lang=mr
shortcodehub | CREATED - po-files/plugins/shortcodehub/mr/wp-plugins-shortcodehub-dev-mr.po | https://translate.wordpress.org/projects/wp-plugins/shortcodehub/dev/mr/default/export-translations
shortcodehub | CREATED - po-files/plugins/shortcodehub/mr/wp-plugins-shortcodehub-dev-readme-mr.po | https://translate.wordpress.org/projects/wp-plugins/shortcodehub/dev-readme/mr/default/export-translations
shortcodehub | CREATED - po-files/plugins/shortcodehub/mr/wp-plugins-shortcodehub-stable-mr.po | https://translate.wordpress.org/projects/wp-plugins/shortcodehub/stable/mr/default/export-translations
shortcodehub | CREATED - po-files/plugins/shortcodehub/mr/wp-plugins-shortcodehub-stable-readme-mr.po | https://translate.wordpress.org/projects/wp-plugins/shortcodehub/stable-readme/mr/default/export-translations
Now, Im using command wp wpi18n generate_plugin_po shortcodehub --lang=mr to auto generate the .po files.
E.g. It looks like below:
D:\xampp\htdocs\wpi18n\wp-content\plugins\wp-i18n (master)
λ wp wpi18n generate_plugin_po shortcodehub --lang=mr
shortcodehub | 4 | 178 | 4508 UPDATED Documentation | WITH डोक्युमेंटशन
shortcodehub | 4 | 177 | 0 NOT EXIST Support
...
...
shortcodehub | 1 | 2 | 0 NOT EXIST Fix: Updated wrong 5 star rating link from dashboard page
shortcodehub | 1 | 1 | 0 NOT EXIST Initial release
shortcodehub | 1 | COMPLETE - TRANSLATED 36 STRINGS
shortcodehub | 1 | po-files/plugins/shortcodehub/mr/wp-plugins-shortcodehub-stable-readme-mr-translated.po
shortcodehub | TOTAL TRANSLATED 36
ALL TRANSLATED STRINGS COUNT: 2901
Screenshot for reference:
After executing both commands we have 36 auto translated strings. Also we have 2901 available strings in Marathi language.
All translated strings are stored in directory: /wp-i18n/po-files/plugins/shortcodehub/mr/
Now file wp-plugins-shortcodehub-dev-mr.po is original file and wp-plugins-shortcodehub-dev-mr-translated.po is translated file.
We can use this auto translated file and import into Glotpress.
To confirm the translated strings the log file is generated which show all the translated strings. E.g. /wp-i18n/po-files/plugins/shortcodehub/mr/log.txt
This file show the content like below:
1 | Documentation | डोक्युमेंटशन
2 | Version %s | आवृत्ती %s
...
...
36 | Features | वैशिष्ट्ये
I notice that there are lot of common strings which are already translated in WordPress core releases.
E.g. Strings Leave a comment, Comment Content, Comment Date, Completed are some of the common strings examples which already translated into WordPress core releases.
In this article I’m giving an example of Marathi (मराठी) (mr) which have now 160 contributors.
With this option we can export the translated project translated strings in below formats:
Android XML (.xml)
Portable Object Message Catalog (.po/.pot)
Machine Object Message Catalog (.mo)
.NET Resource (.resx)
Mac OS X / iOS Strings File (.strings)
Java Properties File (.properties)
JSON (.json)
Jed 1.x (.json)
NGX-Translate (.json)
Development Background
I have create a fresh WordPress setup and created a plugin wpi18n.
In this plugin I have register a post type which store the original string as a post title.
And its translated language version in post meta.
E.g.
Now,
I have downloaded the .po files of all the core projects from 4.1.x to dev with the help of WP CLI command wp wpi18n download_all_core_files
We have all the translated files of each core release of each language. To process all languages it takes too much time. So, I have added the individual language support for importing the translated strings.
The CLI command wp wpi18n import_translated_strings mr download the original & translated string in Marathi language.
After importing strings, I notice that there are lot of strings which are translated as different in different core projects.
E.g. The string Leave a comment is translated as below:
टिपणी करा (4-1-x)
प्रतिक्रिया लिहा (4-2-x)
टिपणी करा (4-3-x)
टिपणी करा (4-4-x)
टिपणी करा (4-5-x)
टिपणी करा (4-6-x)
टिपणी करा (4-7-x)
टिपणी करा (4-8-x)
टिपणी करा (4-9-x-development)
So, To keep the consistency I have used most repetitive strings as a translated strings. E.g.
(8 times) टिपणी करा
(1 times) प्रतिक्रिया लिहा
So, I have used string टिपणी करा to auto translate the string Leave a comment in theme and plugin.
Some other examples:
Example 2: String – Password: have 3 variations in Marathi (mr) language as below:
To detect all the repeated strings I have created the command which generate the file of all repeated strings.
To discuss with other teammates and confirm it works for all languages I have created a log file which show the original string and its log of repetitive strings with most repetitive string.
Below are the some language files:
ru [85] – http://tinyurl.com/yb9ew4yk
ary [264] – http://tinyurl.com/y7achghc
mr [683] – http://tinyurl.com/y8m4vdb2
hi [1103] – http://tinyurl.com/y9pgvllx
To translate the string into any language I have create a command which set the most repeated string into the meta box.
E.g. String Sites is most 3 time repeated with Сайты So, I have set this most repeated string and used it while translating the string with CLI.
I have created some commands to auto generate the .po file of any theme/plugin.
// Commands to download the .po files of theme/plugin.
wp wpi18n download_plugin_po {plugin-slug} --lang={language}
wp wpi18n download_theme_po {theme-slug} --lang={language}
// Commands to generate the .po files of theme/plugin.
wp wpi18n generate_theme_po {theme-slug} --lang={language}
wp wpi18n generate_plugin_po {plugin-slug} --lang={language}
To confirm strings, I have first used my own native language and I found that its 100% works. After that I have tried another language.
After translating plugins and themes I found that the Import Translation feature just import any .po file and detect the string into it.
Finally, I have create each language .po file which set the most repeated string as a translation string. And imported it into the theme/plugin. And it works as expected.
Known Issues
After discuss with yui, I found that the repeated strings are depends on plural/singular, male, female or neutral or sometimes its participle highly depends on context.
The string Sites is translated as in (4-1-x-administration-network-admin) as сайтов because it has the context.
And in (4-1-x) its Сайты because there is no context.
While translating strings It does not check its context. I’ll discuss with community and maybe change this or maybe implement another way to do this same thing.
GlotPress Background
WordPress use the GlotPress to translate the strings from WordPress Core, Themes, Plugins etc.
In GlotPress Roadmap there is a target Translation Memory which is scheduled for version x+5. It is the almost same as reusing strings from existing approved strings.
I have read about this from below reference links:
I’ll discuss this with the Polyglot team on slack channel. You can also try this for your theme/plugin. Its super easy. Just you wan’t to setup the WP CLI on your local environment.
/*
* Use feature detection to determine whether inputs should use
* the `keyup` or `input` event. Input is preferred but lacks support
* in legacy browsers. See changeset 34078, see also ticket #26600#comment:59
*/
if ( 'oninput' in document.createElement( 'input' ) ) {
inputEvent = 'input';
} else {
inputEvent = 'keyup';
}
$( '#widgets-search-input' ).on( inputEvent, function() {
var search_term = $('#widgets-search-input').val() || '',
parent = $('#widgets-left'),
widgets = parent.find('.widget'),
widget_titles = parent.find('.widget-title');
if( search_term.length ) {
// Hide all widgets. Because, Below we show those widgets
// which have search term in the widget title.
widgets.addClass('hide-widget').removeClass('show-widget');
// Search widget and ONLY show these widgets which "contain" the widget title.
var rex = new RegExp( search_term, 'i');
widget_titles.filter(function () {
var widget_name = $.trim( $(this).text() ) || '';
return rex.test( widget_name );
}).parents('.widget').removeClass('hide-widget').addClass('show-widget');
} else {
// Show all widgets.
widgets.removeClass('hide-widget').addClass('show-widget');
}
});
