What is Yatterukun WordPress Plugin
A free and simple WordPress Plugin that allows you to replace image/video media files from smartphones without WordPress administration.
Yatterukun waits for file upload from client device and replace the old file to the newly uploaded one. The change will be reflected immediately on your WordPress page.
For client side, Yatterukun App is available on Google Play and App Store.
How to get Yatterukun WordPress plugin
Yatterukun is available in WordPress official plugin directory.
WordPress official plugin directory
You can install Yatterukun plugin from your WordPress dashboard.
- Go to Plugins -> Add New
- Search “yatterukun”
- Find Yatterukun from the search result
- Click on the “Install button”
- Wait for a few seconds until the orange icons stops spinning
- Click on “Active” button
Security
Yatterukun Plugin strictly controls file upload request as follows.
- Check the URL
- Check the user name
- Check the key
- Check the data name
- Check the file size
- Check the file type
How to use
1. Settings
Yatterukun setting menu is located Settings > Yatterukun.
Page slug
Slug (URL part) of the destination page of the HTTP(S) POST request. The URL will be like below.
your WordPress address/slug
A new page will be automatically added with this slug.
User name
Yatterukun plugin checks the value of the key named “username” in the POST request. If this key does not exist or this value does not match, yatterukun plugin would reject the request.
If you use Yatterukun App as a mobile client, the option parameter in HTTP(S) POST setting would look like below.
- “name” : “username”
- “value” : the value you set here
Upload key
Yatterukun plugin checks the value of the key named “uploadkey” in the POST request. If this key does not exist or this value does not match, yatterukun plugin would reject the request.
If you use Yatterukun App as a mobile client, the option parameter in HTTP(S) POST setting would look like below.
- “name” : “uploadkey”
- “value” : the value you set here
Data name
The “name” attribute of the uploading file in the multipart/form-data, not the file name itself. “yatterukun_data” is the default name. If this name does not match, yatterukun plugin would reject the request.
If you use Yatterukun App as a mobile client, the “data name” in HTTP(S) POST setting would be this value.
Upload max file size
Yatterukun plugin checks the byte size of the uploading file. If the size exceeds this limit, Yatterukun plugin would reject the request.
This value should be less than or equal the system’s “upload_max_filesize” value.
Allowed file types
Yatterukun plugin checks the file extension of the uploading file. If it does not exist in the allowed list, Yatterukun plugin would reject the request.
When “.mov” file type is allowed, “.mov” extension of the uploaded file would automatically be renamed to “.mp4” extension by Yatterukun plugin.
2. Upload Destination Page
After completing settings, you will find new page “Yatterukun upload page” in WordPress “Pages” menu which is automatically created. No need any contents in this page, because Yatterukun plugin rejects “GET” request on this page and returns “404 Page Not Found”.
If you use Yatterukun App as a mobile client, the “POST URL” in HTTP(S) POST setting would look like below.
- your WordPress address/slug
Settings completed
Now your Yatterukun setup is complete.
3. Place Media Placeholder
Just after installing this plugin, you will see “yatterukun.mp4” and “yatterukun.jpg” files which are newly created in your Media Library.
These 2 files are dummy files that would be used as placeholders.
You can place these dummy files any where on your pages just like other media files.
Once you are ready, upload pictures/videos form your smartphone. You will see all the dummy files in your site would replaced into the new one right then.
Note
Please do not edit the dummy files. Yatterukun plugin will not work if you edit dummy files (rotate, crop, scale, etc).
4. Work With Theme’s Custom-Header
Since the Custom headers is a WordPress theme feature, Yatterukun plugin can’t handle image/video in the header media. To achieve this, we need to create a child theme and put some code in it.
As a working example, we provide a child theme for Twenty Seventeen. You can download it from the GitHub link below.
GitHub – twentyseventeen-child-yatterukun
Media Upload Tips
- Attention, a photo taken with an average modern smartphone is easily over 5MB in file size.
- You should mute the video before upload. Otherwise, auto-play will not work.
Yatterukun App resolves these problems.