Errors & Debugging
In short: unzip, keep the files in a folder called
Jeffrey Friedl (author of many LR plugins) wrote an amazing article about how to install those plugins. It is the best article so I don’t even want to attempt to write a better one. It is here: Installation and Management of LR Plugins.
Firewall & Security Plugins
Make sure you whitelist this URL on your site: /?wplr-sync-api
Connection / Publish Issues
Let’s see why the connection between the LR plugin and the WP plugin is not working. Please check every item of this list carefully. This covers 99.8% of the issues.
1. Lightroom Engine generates the image based on your Export Settings.
2. WP/LR Sync uploads this image from Lightroom to WordPress, as the original (full-size) image.
3. Thumbnails are created. Their numbers depend on your theme, and the plugins you might be using (WooCommerce adds many sizes for example).
4. If you are using a Retina, or WebP plugin, those images are created.
5. If you are using an Image Optimization plugin, all the images previously created will be optimized (that is a heavy operation).
6. More can happen depending on your plugins.
Servers usually only allow 30 seconds for a process to run (here, it concern the Step 3 to Step 6). If this process takes more time, the server ends it abruptly. There is unfortunately not way to go around this. In the case of WP/LR Sync, Lightroom will never ever know if the image was uploaded successfuly or not.
The size of the image generated by Lightroom influences the whole process, in an exponential way. So you should absolutely make sure the image generated by Lightroom isn’t huge. On the Lightroom side, in the Settings of the Publish Service, check the Export panel.
To understand more about timeouts and how to resolve them, have a look at this article: https://meowapps.com/fix-timeout-error-wordpress/.
Another way is to add an entry to the Whitelisted URLs in your Firewall. Try this (yes, the URL is just a slash):
Param Type: POST Body
Param Name: filePath
If you find another way to skip Wordfence, let me know (don’t hesitate to contact them).
– Maintenance Mode is enabled (or using plugins like Coming Soon Page, Maintenance Mode,…)
– Privacy Mode is enabled (hosting services such as Flywheel have a feature called like this)
– The WP REST API is disabled by a security plugin (for example WP SpamShield and its Disable anti-spam for miscellaneous forms option )
you are using a captcha or something similar that restricts the access, for example by using reCAPTCHA
– The wp-admin not directly accessible, or the website access has been limited through the .htaccess (the Authentification Required popup)
– Make sure you are not using those plugins: Clef, Google Authenticator, NinjaFirewall+, WP SpamShield, ShieldSecurity, Force Login, etc…
Once you found why it is not working, you need to find an alternative to do what you need.
If the issue comes from a security plugin, you will need to ask the developers of that security plugin to find a way to let WP/LR Sync go through. For your information, WP/LR Sync needs access to the WP-JSON API, and it also uses the wp_authenticate function to resolve your credentials.
Your PHP error logs are made accessible by your hosting service, if you don’t know where they are, the best is to ask them. You can also try to use such a plugin as Error Log Monitor (but they don’t always detect the error file). If you are willing to learn more about checking errors by yourself, check this: Monitor PHP Errors. Be careful, the PHP Error Logs is not the Access Error Logs, they are two different things.
Your PHP error logs are empty? It might not be normal, PHP error logs usually have notices, warnings, and errors. Please make sure the errors are actually being logged. For that, you can edit your functions.php (what is functions.php?) and insert such a line:
error_log( “Hello Error Logs!” );
Then load any page on your website, and check your PHP Error Logs again. If they are empty, it means that they are not working. Contact your hosting service in that case. Don’t forget to remove this line from your functions.php.
Alternatively, you can also have a look at your WPLRSync.log located in your Documents folder (LrClassicLogs directory), it sometimes contains interesting information.
I had myself issues with plugins such as Media Library Assistant and WP Fastest Cache.
Did nothing work?
I will not be able to give you more advice than what is on this page. The only way to debug your issue further is to:
- Get your PHP Error Logs. This file is really necessary for debugging the issue. If you don’t find it, or if it is empty, have a look at this: How to Debug WordPress.
- Get your WPLRSync.log. This file is on your own system, in the Documents folder (LrClassicLogs directory). If it is huge, delete it, reproduce the issue, and get the new WPLRSync.log file.
- Contact me, and share with me those two files, and possibly, access to your install.
It is really important to follow this process to make sure that I can help you. Thank you.
In the Media Library, the images are ordered by a field internally known as Upload Date, it is shown as the Date column. So basically the latest image you upload will be at the top. In Lightroom, you can choose that by drag & drop the images about to be sent for the first time (in New Photos to Publish). Then Publish. The last image to be uploaded will appear first in the Media Library.
Another way is to use the Use Photo Taken Date. I recommend this because the plugin will override the default process and use the Taken Date of the photo as the Upload Date. That will make your Media Library clean, with useful and re-usable data.
If you want to order images within a gallery synchronized by WP/LR Sync, this is possible. You need to use Custom Order in Lightroom for this specific gallery, and trigger a Re-Publish for any photo within this gallery to trigger this ordering update.
Of course, this could be the cache at many different level, so depending on the plugins and systems you are using for this, the way to resolve it is very different. Photon is also known to do that.
The only way to make sure the new image has been uploaded and synchronized, is to download the file by FTP and open it. Please do this before trying to check if there is an issue with the plugin itself.
Another way is to take advantage of the API available in WP/LR Sync. One of my users, Geet, wrote some code that keeps his custom meta (city, country) synchronized from the IPTC information. The code is available here.
Theme Assistant Extension
Is the Hierarchy is right but your WordPress doesn’t have the Posts/Pages/Galleries (or whatever you linked it to) the same, try to Reset the Extensions, then Sync the Extensions again (in the Extensions menu). That will call your extensions (and therefore, the Post Types extension) to re-do everything.
Issues with Extensions