Importazione dei video

TubePress può riempire la tua libreria in diversi modi — dall'aggiunta manuale di un singolo clip all'importazione di centinaia di migliaia di video pronti dal cloud. Questa pagina copre l'importatore integrato e mostra dove si trovano le altre modalità.

Qualunque metodo tu scelga, il risultato è lo stesso: video ordinari che puoi modificare, organizzare, moderare e pubblicare come qualsiasi altro. Scegli quello che si adatta alla quantità di contenuti che hai e a se vuoi un caricamento una tantum o qualcosa che si aggiorna continuamente.

Modi per importare contenuti in TubePress

Non esiste un unico modo "giusto" per aggiungere video — ogni metodo si adatta a una scala e un flusso di lavoro diversi. Usa la tabella seguente per scegliere, poi segui il link per i dettagli.

Importazione di un singolo video

TubePress non ha un importatore separato per "un video" — per aggiungere un singolo video usa la schermata Video su /admin/videos e scegli Aggiungi Video. Ci sono due modi per fornire il contenuto multimediale:

• Caricamento manuale — carica un file video che ospiti tu stesso.
• Importazione singola URL — incolla un codice embed <iframe> o un URL video diretto per incorporare un clip ospitato altrove.

Compila il titolo e la miniatura, collega eventuali categorie, tag o performer, poi salva come bozza o pubblica direttamente. Nessuna delle due modalità utilizza crediti.

Importazione in blocco

L'importazione in blocco si trova nella scheda Carica File di /admin/import. Accetta un singolo file CSV o JSON — non un elenco di URL incollato — e trasforma ogni riga o oggetto in un video.

• Il file CSV deve avere una riga di intestazione e usare le virgole come separatori.
• Il file JSON deve essere un array di oggetti.

Trascina il file sulla zona di caricamento (o fai clic per sfogliare) e TubePress legge le colonne e mostra un'anteprima. Un CSV minimale ha questo aspetto:

title,embed_code,thumbnail,duration,tags
My clip,https://ex.com/v/123.mp4,https://ex.com/t.jpg,612,"solo,hd"

Poi mappi le tue colonne sui campi di TubePress trascinandole nella posizione corretta. I campi riconosciuti dall'importatore includono:

Prima di iniziare, imposta come vengono gestiti i duplicati (salta o aggiorna, corrispondenza su video_id), se scaricare le miniature per servirle dal tuo storage, ed eventuali riscritture o traduzioni AI opzionali.

Come funziona la coda di importazione

Per qualsiasi cosa oltre a un file piccolo, scegli Avvia in background. TubePress crea un job e lo affida al processore di importazione, che lavora sulle tue righe anche dopo aver chiuso la scheda. Non è richiesto alcun crontab di sistema — funziona sul pseudo-cron integrato.

Il processore è progettato per essere sicuro e resiliente:

• A blocchi. Le righe vengono importate poche alla volta così un web worker non viene mai bloccato; una velocità di importazione regolabile controlla quante per blocco.
• Asincrono. Il pseudo-cron raccoglie il job man mano che il sito riceve traffico, e la pagina di importazione lo sollecita mentre è aperta.
• Auto-ripristino. Un job che si blocca — ad esempio per un riavvio del server a metà esecuzione — viene rimesso in coda automaticamente dopo circa cinque minuti e continua da dove si era fermato.
• Deduplicazione. Le righe con un video_id noto vengono saltate o aggiornate anziché duplicate.
• Tollerante. Una riga errata viene registrata (vengono campionati i primi errori per blocco) e il job continua.

Monitorare l'avanzamento dell'importazione

Apri /admin/import e osserva la Coda di Importazione. Ogni job attivo mostra conteggi in tempo reale — importati, saltati, errori e elaborati sul totale — aggiornati ogni pochi secondi.

Da qui puoi mettere in pausa, riprendere, annullare o eliminare un job. I job delle ultime 24 ore rimangono elencati così puoi esaminare cosa è successo, inclusi i messaggi di errore campionati per le righe che hanno fallito.

Consigli e limiti

• Vengono accettati solo file .csv e .json; gli altri formati vengono rifiutati immediatamente.
• Il minimo pratico per riga è un titolo più un codice embed e una miniatura.
• La dimensione di caricamento è limitata dai parametri upload_max_filesize e post_max_size del tuo server. Suddividi i file molto grandi, o utilizza un job in background.
• Mappa un video_id stabile così rieseguire un file aggiorna anziché duplicare.
• Abilita Scarica miniature per ospitare le immagini autonomamente invece di hotlinkarle dalla fonte.
• La riscrittura e la traduzione AI consumano crediti e richiedono un account tubepress.io collegato; se il saldo è troppo basso il job si ferma con un messaggio chiaro.

Passi successivi