=== RR Media Offload for S3 / S3-compatible storage ===
Contributors: rrcomputing, rvalverde
Tags: amazon s3, media offload, cloudfront, cdn, wordpress media
Requires at least: 6.0
Tested up to: 7.0
Stable tag: 1.0.1
Requires PHP: 8.0
License: GPL-2.0-or-later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Descarrega la biblioteca multimèdia a S3 i accelera el teu WordPress amb CDN, menys càrrega del servidor i millor rendiment.

== Descripció ==

**Descàrrega de contingut multimèdia RR per a S3** (amb tecnologia de WPtoCloud) carrega automàticament tots els fitxers de la teva biblioteca multimèdia de WordPress a un contenidor compatible amb S3 o S3.

Les imatges, els vídeos i totes les miniatures generades s'emmagatzemen a S3 i es poden servir directament des de l'emmagatzematge al núvol o a través d'una CDN com ara CloudFront.

Això redueix l'ús del disc, millora el rendiment i permet que el vostre lloc web s'escali més fàcilment.

La configuració és senzilla i només triga uns minuts amb l'assistent pas a pas integrat.

== Característiques ==

- Càrrega automàtica de nous fitxers multimèdia a Amazon S3
- Càrrega de totes les miniatures i variants de srcset
- Compatibilitat amb imatges, vídeos i tots els tipus de suports de WordPress
- Reescriptura d'URL per servir fitxers des de S3 o CDN
- Compatible amb CloudFront i dominis CDN personalitzats
- Eliminació opcional de fitxers locals després de la càrrega
- Assistent de configuració pas a pas (cubell, IAM, CDN)
- Tauler d'estat amb mètriques de càrrega i estat de S3
- Funciona amb cubells S3 privats (mitjançant CDN)
- Compatible amb instal·lacions multisite
- Preparat per a traducció (anglès, castellà, francès, portuguès, català)

== Serveis externs ==

**Aquest complement NO carrega fitxers remots de servidors de tercers.**

Tots els recursos del complement (JavaScript, CSS, imatges) s'inclouen localment dins del directori del complement. El complement no crida CDN externes per a la seva pròpia funcionalitat.

**Aquest complement proporciona un servei per connectar el TEU compte d'Amazon S3**

Quan configureu el complement amb les vostres credencials d'AWS, es connecta a:

- **Emmagatzematge compatible amb S3 / S3** - per carregar i emmagatzemar els vostres fitxers multimèdia al vostre propi contenidor
- **CDN (opcional)** - per servir contingut a través d'una CDN com ara Amazon CloudFront o una altra distribució CDN compatible

El complement també funciona amb altres serveis que implementen l'API S3 (emmagatzematge d'objectes compatible amb S3). Si preferiu utilitzar un proveïdor alternatiu, configureu el complement amb el punt final i les credencials d'aquest proveïdor. Els proveïdors compatibles comuns inclouen:

- MinIO (autoallotjat)
- DigitalOcean Spaces
- Wasabi
- Backblaze B2 (API S3)
- Linode Object Storage
- Scaleway Objects
- Ceph (RADOS Gateway)
- IBM Cloud Object Storage (mode compatible amb S3)
- Oracle Cloud (gateway compatible amb S3; pot necessitar ajustaments)
- Cloudian, DreamObjects, Exoscale

Notes per als proveïdors compatibles amb S3:

- És possible que hàgiu de definir un `endpoint` personalitzat (per exemple, `https://nyc3.digitaloceanspaces.com`).
- Alguns proveïdors requereixen `use_path_style_endpoint => true` o `signature_version` específic (normalment `v4`).
- Verifiqueu el comportament de CORS, ACL/lectura pública i els límits de càrrega multipart gran amb el vostre proveïdor.
- Si la interfície d'usuari del connector no exposa un camp d'endpoint, podeu afegir l'endpoint a la configuració del connector o puc actualitzar el connector per afegir una opció de "Endpoint S3 personalitzat".

== Instruccions específiques del proveïdor ==

A continuació es mostren notes breus i específiques del proveïdor per ajudar-vos a configurar el connector quan utilitzeu un emmagatzematge d'objectes compatible amb S3.

=== DigitalOcean Spaces ===
- Exemple de punt final: https://nyc3.digitaloceanspaces.com (substituïu nyc3 per la vostra regió)
- Creeu un espai al tauler de control de DigitalOcean i genereu una clau d'accés / clau secreta a API -> Claus d'espais.
- Utilitzeu el punt final anterior al camp `Punt final` del connector i deixeu Regió a qualsevol (l'SDK utilitzarà el punt final).
- CORS: permeteu GET, HEAD, PUT, POST i definiu Origin al vostre lloc si cal.
- Objectes públics: definiu Space com a públic o utilitzeu URL signades a través de la vostra CDN.

=== MinIO (autoallotjat) ===
- Exemple de punt final: https://minio.example.com:9000
- MinIO normalment requereix `use_path_style_endpoint => true` — activeu "Forzar path-style" a la configuració del connector.
- Assegureu-vos que TLS estigui configurat per a la producció i que els noms dels contenidors segueixin les regles DNS.
- Utilitzeu el client MinIO (`mc`) per crear contenidors i fer càrregues de prova:
- `mc alias set myminio https://minio.example.com ACCESSKEY SECRET`
- `mc mb myminio/my-bucket`

=== Wasabi ===
- Exemple de punt final: https://s3.us-west-1.wasabisys.com (específic de la regió)
- Utilitzeu el punt final del proveïdor al connector i no activeu l'estil de ruta tret que Wasabi ho indiqui.
- Consulteu la documentació de Wasabi per conèixer les polítiques de contenidors i la configuració de CORS.

=== Backblaze B2 (compatible amb S3) ===
- Els punts finals de Backblaze S3 són específics de la regió, p. ex. `https://s3.us-west-002.backblazeb2.com`.
- Utilitzeu el punt final i les vostres claus d'estil S3; proveu amb el botó "Probar conexión" del connector.

=== Emmagatzematge d'objectes Linode ===
- Exemple de punt final: https://us-east-1.linodeobjects.com
- Utilitzeu el punt final a la configuració; Linode admet l'estil d'amfitrió virtual per defecte, normalment no cal cap estil de ruta.

=== Proveïdors personalitzats / altres proveïdors compatibles amb S3 ===
- Si el vostre proveïdor exposa una API compatible amb S3, normalment necessitareu:
- `endpoint` (obligatori)
- `access key` i `secret key`
- opcionalment `use_path_style_endpoint => true` per a passarelles més antigues o autoallotjades
- Problemes comuns: discrepància de versió de signatura (assegureu-vos `v4`), restriccions CORS o límits específics del proveïdor per a càrregues multipart.

Si teniu problemes, copieu el punt final i les claus del proveïdor a la configuració del connector i utilitzeu "Probar conexión". Si la prova falla, activeu path-style i torneu-ho a intentar, o compartiu el missatge d'error per obtenir més ajuda.

**Quines dades s'envien:**

- Fitxers multimèdia carregats pel vostre lloc de WordPress (imatges, vídeos, miniatures)
- Sol·licituds d'API que utilitzen les VOSTRES credencials d'AWS per gestionar el VOSTRE cub
- Totes les connexions es fan només als VOSTRES recursos d'AWS configurats

**Requisit del compte d'AWS:**

Heu de crear el vostre propi compte d'AWS i configurar el vostre propi cub S3 i la distribució opcional de CloudFront. El connector no proporciona aquests serveis; simplement connecta WordPress als serveis d'AWS que VOSALTRES configureu.


**Seguretat de les credencials:**


- Les vostres credencials d'AWS s'emmagatzemen xifrades a la vostra base de dades de WordPress.


- Les credencials NOMÉS s'utilitzen per comunicar-se amb el vostre propi compte d'AWS.


- No s'envien dades a servidors de tercers ni al desenvolupador del connector.


**Les URL que es mostren a l'administrador del connector són només enllaços informatius:**


L'assistent de configuració mostra enllaços en què es pot fer clic per ajudar-vos a obrir les pàgines correctes de la consola d'AWS:


- `https://s3.console.aws.amazon.com/s3/home` - Obre la vostra consola d'AWS S3 (per a la creació de cubs)


- `https://console.aws.amazon.com/iam/home#/users` - Obre la vostra consola d'IAM (per crear claus d'accés)


- `https://console.aws.amazon.com/cloudfront/home` - Obre la vostra consola de CloudFront (configuració de CDN opcional).


Aquestes són les URL estàndard de la consola d'AWS que es proporcionen com a guia per a l'usuari. NO són ​​dependències externes carregades pel temps d'execució del connector.

**Exemple de marcador de posició que es mostra a l'assistent de configuració:**

L'assistent mostra un exemple de format d'URL de CloudFront com ara `https://d1ab2cde.cloudfront.net` com a referència visual. Aquest és només un exemple de marcador de posició; no és un punt final real. El connector només utilitza l'URL de la CDN que configureu amb el VOSTRE domini de CloudFront.

**Més informació:**

- Termes del servei d'AWS: https://aws.amazon.com/service-terms/
- Avís de privadesa d'AWS: https://aws.amazon.com/privacy/

== Instal·lació ==

1. Pugeu el connector al directori /wp-content/plugins/ o instal·leu-lo des del repositori de WordPress.

2. Activeu el connector a través del menú Complements.
3. Aneu a **WPtoCloud -> Configuració**
4. Configureu el vostre contenidor S3 i les credencials IAM
5. (Opcional) definiu una URL de CloudFront o CDN

== Preguntes freqüents ==

= Què fa aquest complement? =
Puja automàticament els continguts multimèdia de WordPress a Amazon S3 i serveix fitxers des de l'emmagatzematge al núvol.

= És compatible amb CloudFront? =
Sí, podeu configurar una URL de CDN per a un lliurament ràpid.

= Es migren els fitxers existents? =
No. La versió gratuïta només gestiona les càrregues noves.

= Puc suprimir fitxers locals? =
Sí, podeu habilitar la supressió automàtica un cop el fitxer s'ha carregat a S3.

= Funciona amb contenidors privats? =
Sí, quan s'utilitza amb CloudFront o una CDN compatible.

= Són segures les credencials d'AWS? =
Sí. S'emmagatzemen xifrades a la vostra base de dades de WordPress.

= Què és WPtoCloud? =
WPtoCloud és la plataforma darrere de RR Media Offload, que proporciona funcions avançades i eines premium per a la gestió de contingut multimèdia al núvol.

== Actualitza a WPtoCloud Pro ==

Desbloqueja funcions avançades amb **WPtoCloud Pro**:

- Migració massiva de contingut multimèdia a Amazon S3
- Eines d'automatització avançades
- Neteja de contingut multimèdia de WooCommerce
- Informes i monitorització detallats
- Assistència prioritària

Obtén WPtoCloud Pro:
https://www.wptocloud.com

== Registre de canvis ==
= 1.0.0 =
- Llançament inicial

= 1.0.1 =
- S'ha afegit compatibilitat amb proveïdors compatibles amb S3: DigitalOcean Spaces, MinIO, Wasabi, Backblaze, Linode i una opció personalitzada.
- Noves configuracions: `Proveïdor S3`, `Punt final` i `Força l'estil de ruta`.
- `RRCM_Media_Offload_S3_Manager` ara accepta un punt final personalitzat i `use_path_style_endpoint` quan està configurat.
- S'ha afegit un botó "Prova la connexió" a la pantalla de configuració per verificar les credencials i el punt final.
- Canvis mínims i compatibles amb versions anteriors: la configuració existent d'AWS no es veu afectada.
- S'han corregit errors de traducció al codi del connector (s'han corregit les cadenes d'i18n de WordPress).

== Avís d'actualització ==
= 1.0.1 =
- Vegeu el registre de canvis anterior per obtenir més informació.