WebMasterService N3rds@Work

Psource Mediathek API-Handbuch

Du siehst derzeit eine Revision mit dem Titel "Psource Mediathek API-Handbuch", die von DerN3rd auf 8. September 2021 um 16:56 gespeichert wurde.
Titel
Psource Mediathek API-Handbuch
Inhalt
Willkommen beim Lifecycle-Leitfaden für MediaPress-Uploader-Ereignisse. Der Leitfaden richtet sich an Entwickler, die ihre eigene Upload-Erfahrung mit MediaPress erstellen möchten. MediaPress verwendet plupload.Uploader zum Hochladen von Dateien. Es ist die gleiche Bibliothek, die von WordPress verwendet (und damit gebündelt) wird. Wir haben eine Container-Klasse mpp.Uploader. Die verschiedenen Instanzen von mpp.Uploader ermöglichen uns das Hochladen von Dateien. Hinweis:- Alle auf dieser Seite aufgelisteten Ereignisse werden vom MediaPress-Uploader (mpp.Uploader) für das Dokumentobjekt ausgelöst. Liste der Phasen, in die Sie sich einklinken können.
Für alle auf dieser Seite aufgeführten Ereignisse erhält jeder gebundene Ereignis-Listener-Callback das Event-Objekt als ersten Parameter (Sie werden es meistens ignorieren) und eine Instanz von mpp.Uploader als zweiten Parameter. Der Rest der Parameter wird durch die Ereignisse bestimmt, an die Sie sich anschließen müssen. Außerdem werden die Ereignisse auf dem Dokumentobjekt  ausgelöst . Die Ereignis-Listener sollten an das Dokumentobjekt gebunden sein, um das Ereignis korrekt abzufangen.

Bei Dateiauswahl:-

Sobald der Benutzer eine oder mehrere Dateien auswählt, werden die Dateien unserer Upload-Warteschlange hinzugefügt. mpp.Uploader löst nach der Dateiauswahl zwei Ereignisse aus.
  • mpp:uploader:file.added :- Wird ausgelöst, wenn eine Datei zur Upload-Warteschlange hinzugefügt wird. Es wird für jede Datei der Auswahl ausgelöst (bei Mehrfachauswahl)
  • mpp:uploader:files.added :- Dieses Ereignis wird ausgelöst, wenn alle Dateien aus der Auswahl erfolgreich zur Upload-Warteschlange hinzugefügt wurden.

mpp:uploader:file.added :-

Ein an dieses Ereignis gebundener Zuhörer erhält 3 Argumente
  • Ereignisobjekt.
  • mpp.Uploader-Instanz
  • Datei Backbone.Model-Instanz
Beispiel :- Anhängen eines Listeners mit Javascript. Wenn Sie wissen möchten, welcher Uploader dies ausgelöst hat (z. B. arbeiten wir mit Aktivitäts-Upload oder Galerie-Upload oder Shortcode-Upload usw.), lesen Sie bitte die Anleitung, um dies zu bestimmen .

mpp:uploader:files.added :-

Es wird ausgelöst, wenn alle ausgewählten Dateien zur Upload-Warteschlange hinzugefügt wurden. Ein an dieses Ereignis gebundener Zuhörer erhält die folgenden Argumente
  • Ereignisobjekt
  • mpp.Uploader-Objekt
  • plupload.Uploader-Instanz
Beispiel:-

Beim Hochladen-Start:-

Bevor der Upload für jede der Dateien beginnt, wird das folgende Ereignis ausgelöst
  • mpp:uploader:before.upload
Der gebundene Hörer erhält folgende Argumente
  • Ereignisobjekt
  • mpp.Uploader-Instanz
  • plupload.Uploader-Instanz
  • Datei Backbone.Model-Instanz
Sie können diesen Hook verwenden, um das Hochladen einer Datei zu stoppen. Beispiel:-  

Beim Upload-Fortschritt:-

Wenn Sie Hooks benötigen, um den Fortschritt hochzuladen und etwas zu tun, können Sie das Ereignis verwenden:
  • mpp:uploader:upload.progress
Der gebundene Listener erhält folgende Argumente:
  • Ereignisobjekt
  • mpp.Uploader-Instanz
  • Anhang: - Backbone-Modellobjekt, das Details zur hochgeladenen Datei enthält.
Das Ereignis gibt Ihnen Zugriff auf mpp.Uploader und das Attachment-Objekt. Im Anhang können Sie nach den Eigenschaften "geladen", "Prozent" suchen, um den Upload-Fortschritt zu überprüfen. Beispiel:-  

Bei erfolgreichem Upload:-

Wenn eine Datei erfolgreich hochgeladen wurde, wird das folgende Ereignis dafür ausgelöst
  •  mpp:uploader:upload.success
Dies wird sogar für jede Datei einzeln ausgelöst. Der an dieses Ereignis angehängte Listener erhält folgende Argumente
  • Ereignisobjekt
  • mpp.Uploader-Instanz
  • Anhang: - Backbone-Modellobjekt, das Details zur hochgeladenen Datei enthält.
Beispiel:-

Bei allen Upload abgeschlossen:-

Wenn alle Dateien aus der aktuellen Warteschlange hochgeladen wurden, löst der Uploader das Ereignis aus:
  • mpp:uploader:upload.complete
Ein daran angeschlossener Zuhörer erhält 4 Argumente
  • Ereignisobjekt
  • mpp.Uploader-Instanz
  • plupload.Uploader-Instanz
  • Backbone-Sammlung von Dateien.
Beispiel:-

Bei Fehler:-

Bei allen Arten von Fehlern (möglicherweise ein Fehler bei der Dateiauswahl oder beim Upload-Fehler) löst MediaPress ' mpp:uploader:error ' aus. Der an dieses Ereignis angehängte Listener erhält 4 Argumente
  • Ereignisobjekt
  • mpp.Uploader-Instanz
  • Nachrichtenzeichenfolge
  • Datenobjekt
  • Dateiobjekt
Beispiel:-  

Überprüfung des Uploader-Typs:-

In allen Listenern erhalten Sie als zweites Argument die Instanz des aktuellen MediaPress-Uploaders. Sie müssen sich nicht um die Uploader-Prüfung kümmern, wenn Sie bei allen Uploads eine Aktion ausführen möchten, unabhängig davon, ob sie gerade hochgeladen werden. Es kann vorkommen, dass Sie feststellen möchten, welcher Uploader verwendet wurde (war es ein Galerie-Upload oder geschah es auf Aktivität?). Bevor wir es bestimmen, müssen Sie die Art der mpp.Uploader-Instanzen kennen, die von MediaPress verwendet werden. In MediaPress erstellen wir mehrere Instanzen des mpp.Uploader zum Hochladen in Aktivität, einzelne Galerie, mit Shortcode, Cover-Upload. Hier ist die Liste des Instanzobjekts.
  • mpp.activity_uploader :- unser Aktivitäts-Uploader.
  • mpp.guploader :- Galerie-Uploader
  • mpp.shortcode_uploader :- Shortcode-Uploader
  • mpp.cover_uploader :- Cover-Uploader
Um den Typ des Uploaders zu bestimmen, vergleichen Sie das 2. Argument mit einem der obigen Argumente. Wenn ich beispielsweise überprüfen möchte, ob der Upload von der Aktivität abgeschlossen ist, gehe ich wie folgt vor:

Weiterlesen

Auszug


Alt Neu Datum erstellt Author Actions
8. September 2021 um 15:57 DerN3rd
8. September 2021 um 15:25 DerN3rd
8. September 2021 um 15:11 DerN3rd
8. September 2021 um 14:56 DerN3rd
6. Januar 2021 um 00:20 DerN3rd