https://github.com/frugan-dev/upload-field-to-youtube-for-acf
Upload Field to YouTube for ACF is a WordPress plugin that allows you to upload videos directly to YouTube via API from the WordPress admin area
https://github.com/frugan-dev/upload-field-to-youtube-for-acf
acf acf-addon acf-field php scf wordpress wordpress-plugin youtube youtube-api
Last synced: about 2 months ago
JSON representation
Upload Field to YouTube for ACF is a WordPress plugin that allows you to upload videos directly to YouTube via API from the WordPress admin area
- Host: GitHub
- URL: https://github.com/frugan-dev/upload-field-to-youtube-for-acf
- Owner: frugan-dev
- License: gpl-3.0
- Created: 2024-11-06T11:21:02.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2024-12-03T14:48:07.000Z (5 months ago)
- Last Synced: 2025-01-19T07:42:19.578Z (3 months ago)
- Topics: acf, acf-addon, acf-field, php, scf, wordpress, wordpress-plugin, youtube, youtube-api
- Language: PHP
- Homepage:
- Size: 194 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: .github/CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: .github/CODE_OF_CONDUCT.md
- Security: .github/SECURITY.md
- Support: .github/SUPPORT.md
Awesome Lists containing this project
README
# Upload Field to YouTube for ACF (WordPress Plugin)
__Upload Field to YouTube for ACF__ is a WordPress plugin that allows you to upload videos directly to YouTube via API from the WordPress admin area and/or select existing videos on your YouTube channel based on playlists. It is particularly useful for managing videos that may be associated with Custom Post Types (CPT).
To use this plugin, you need to configure Google oAuth credentials so the plugin can authenticate with the user's YouTube channel.
## Requirements
- PHP ^8.0
- WordPress ^5.7 || ^6.0
- [Advanced Custom Fields](https://www.advancedcustomfields.com) ^5.9 || ^6.0
## Features
- direct video upload to YouTube from CPTs within the WordPress interface
- selection of existing YouTube videos, filtered by playlists
- support for "unlisted" video privacy, making this plugin ideal for managing private or exclusive videos tied to specific content
- use official [ACF Example Field Type](https://github.com/AdvancedCustomFields/acf-example-field-type)
- support for logging with [Wonolog](https://github.com/inpsyde/Wonolog) ^2.x, if available
- made with [Vanilla JS](http://vanilla-js.com) (no jQuery)
- autoload classes with Composer and PSR-4
- support ACF nested repeater
- translations managed via [Crowdin](https://crowdin.com/project/upload-field-to-youtube-for-acf)
## Installation
You can install the plugin in three ways: manually, via Composer (wpackagist) _(coming soon)_ or via Composer (package).
Manual Installation
1. Go to the [Releases](../../releases) section of this repository.
2. Download the latest release zip file.
3. Log in to your WordPress admin dashboard.
4. Navigate to `Plugins` > `Add New`.
5. Click `Upload Plugin`.
6. Choose the downloaded zip file and click `Install Now`.
Installation via Composer "wpackagist" (coming soon)
If you use Composer to manage WordPress plugins, you can install it from [WordPress Packagist](https://wpackagist.org):
1. Open your terminal.
2. Navigate to the root directory of your WordPress installation.
3. Ensure your `composer.json` file has the following configuration: *
```json
{
"require": {
"composer/installers": "^1.0 || ^2.0",
"wpackagist-plugin/upload-field-to-youtube-for-acf": "^0.1"
},
"extra": {
"installer-paths": {
"wp-content/plugins/{$name}/": [
"type:wordpress-plugin"
]
}
}
}
```
4. Run the following command:
```sh
composer update
```
_Note:_
_* `composer/installers` might already be required by another dependency._
Installation via Composer "package"
If you use Composer to manage WordPress plugins, you can install it from this repository directly:
1. Open your terminal.
2. Navigate to the root directory of your WordPress installation.
3. Ensure your `composer.json` file has the following configuration: *
```json
{
"require": {
"composer/installers": "^1.0 || ^2.0",
"frugan-dev/upload-field-to-youtube-for-acf": "^0.1"
},
"repositories": [
{
"type": "package",
"package": {
"name": "frugan-dev/upload-field-to-youtube-for-acf",
"version": "0.2.1",
"type": "wordpress-plugin",
"dist": {
"url": "https://github.com/frugan-dev/upload-field-to-youtube-for-acf/releases/download/v0.2.1/upload-field-to-youtube-for-acf.zip",
"type": "zip"
}
}
}
],
"extra": {
"installer-paths": {
"wp-content/plugins/{$name}/": [
"type:wordpress-plugin"
]
}
}
}
```
4. Run the following command:
```sh
composer update
```
_Note:_
_* `composer/installers` might already be required by another dependency._
## Configuration
Once installed:
1. In your WordPress admin dashboard, navigate to the `Plugins` section and click `Activate Plugin`.
2. Create a new field via ACF and select the `YouTube Uploader` type.
3. Read the description above for advanced usage instructions.
### Creating the oAuth Credentials
1. Go to the [Google API Console](https://console.developers.google.com/).
2. Create a project or select an existing one.
3. Navigate to the **OAuth consent screen** section and configure the required details to enable authentication.
4. Then, go to **Credentials** and create an **OAuth 2.0 Client ID**.
5. In the **Authorized redirect URIs** field, enter your WordPress site's callback URL (e.g., `https://domain.tld/wp-admin/`).
6. Obtain the `Client ID` and `Client Secret`.
#### Limitations
If you use the API upload mode, please note this important notice [here](https://developers.google.com/youtube/v3/docs/videos/insert):
> All videos uploaded via the `videos.insert` endpoint from unverified API projects created after July 28, 2020, will be restricted to private viewing mode. To lift this restriction, each API project must undergo an audit to verify compliance with the YouTube Terms of Service.
### Setting in wp-config.php
Add the following lines to `wp-config.php` to define the oAuth credentials:
```php
define('FRUGAN_UFTYFACF_GOOGLE_OAUTH_CLIENT_ID', 'Client ID');
define('FRUGAN_UFTYFACF_GOOGLE_OAUTH_CLIENT_SECRET', 'Client Secret');
```
### Enabling Cache Busting
If you use filename-based cache busting, the plugin supports the following definition in `wp-config.php`:
```php
define('FRUGAN_UFTYFACF_CACHE_BUSTING_ENABLED', true);
```
For more information, see filename-based cache busting on [Nginx](https://github.com/h5bp/server-configs-nginx/blob/main/h5bp/location/web_performance_filename-based_cache_busting.conf) and [Apache](https://github.com/h5bp/server-configs-apache/blob/main/h5bp/web_performance/filename-based_cache_busting.conf).
## More info
See [LINKS](docs/LINKS.md) file.
## Changelog
See auto-[CHANGELOG](CHANGELOG.md) file.
## Contributing
For your contributions please use:
- [git-flow workflow](https://danielkummer.github.io/git-flow-cheatsheet/)
- [conventional commits](https://www.conventionalcommits.org)
## Sponsor
[
](https://buymeacoff.ee/frugan)
## License
(ɔ) Copyleft 2024 [Frugan](https://frugan.it).
[GNU GPLv3](https://choosealicense.com/licenses/gpl-3.0/), see [LICENSE](LICENSE) file.