(Delphi DLL) WordPress Media Upload

See more WordPress Examples

Demonstrates how to upload a media file to WordPress.

For more information, see https://developer.wordpress.org/rest-api/reference/media/#create-a-media-item

Chilkat for Delphi Downloads Chilkat non-ActiveX DLL for Delphi Chilkat ActiveX DLL for Delphi * The examples here use the non-ActiveX DLL.

uses
    Winapi.Windows, Winapi.Messages, System.SysUtils, System.Variants, System.Classes, Vcl.Graphics,
    Vcl.Controls, Vcl.Forms, Vcl.Dialogs, Vcl.StdCtrls, Http, HttpRequest, DtObj, HttpResponse, JsonObject;

...

procedure TForm1.Button1Click(Sender: TObject);
var
http: HCkHttp;
req: HCkHttpRequest;
success: Boolean;
resp: HCkHttpResponse;
jsonResponse: HCkJsonObject;
date_gmt: HCkDtObj;
href: PWideChar;
embeddable: Boolean;
name: PWideChar;
templated: Boolean;
id: Integer;
date: PWideChar;
guidRendered: PWideChar;
guidRaw: PWideChar;
modified: PWideChar;
modified_gmt: PWideChar;
slug: PWideChar;
status: PWideChar;
v_type: PWideChar;
link: PWideChar;
titleRaw: PWideChar;
titleRendered: PWideChar;
author: Integer;
comment_status: PWideChar;
ping_status: PWideChar;
template: PWideChar;
permalink_template: PWideChar;
generated_slug: PWideChar;
descriptionRaw: PWideChar;
descriptionRendered: PWideChar;
captionRaw: PWideChar;
captionRendered: PWideChar;
alt_text: PWideChar;
media_type: PWideChar;
mime_type: PWideChar;
media_detailsWidth: Integer;
media_detailsHeight: Integer;
media_detailsFile: PWideChar;
media_detailsSizesWoocommerce_gallery_thumbnailFile: PWideChar;
media_detailsSizesWoocommerce_gallery_thumbnailWidth: Integer;
media_detailsSizesWoocommerce_gallery_thumbnailHeight: Integer;
media_detailsSizesWoocommerce_gallery_thumbnailMime_type: PWideChar;
media_detailsSizesWoocommerce_gallery_thumbnailSource_url: PWideChar;
media_detailsSizesShop_thumbnailFile: PWideChar;
media_detailsSizesShop_thumbnailWidth: Integer;
media_detailsSizesShop_thumbnailHeight: Integer;
media_detailsSizesShop_thumbnailMime_type: PWideChar;
media_detailsSizesShop_thumbnailSource_url: PWideChar;
media_detailsSizesFullFile: PWideChar;
media_detailsSizesFullWidth: Integer;
media_detailsSizesFullHeight: Integer;
media_detailsSizesFullMime_type: PWideChar;
media_detailsSizesFullSource_url: PWideChar;
media_detailsImage_metaAperture: PWideChar;
media_detailsImage_metaCredit: PWideChar;
media_detailsImage_metaCamera: PWideChar;
media_detailsImage_metaCaption: PWideChar;
media_detailsImage_metaCreated_timestamp: PWideChar;
media_detailsImage_metaCopyright: PWideChar;
media_detailsImage_metaFocal_length: PWideChar;
media_detailsImage_metaIso: PWideChar;
media_detailsImage_metaShutter_speed: PWideChar;
media_detailsImage_metaTitle: PWideChar;
media_detailsImage_metaOrientation: PWideChar;
post: PWideChar;
source_url: PWideChar;
i: Integer;
count_i: Integer;

begin
// This example requires the Chilkat API to have been previously unlocked.
// See Global Unlock Sample for sample code.

http := CkHttp_Create();

// This example will use WordPress username / Application password authentication using the "Applications Password" plugin.
// See https://wordpress.org/plugins/application-passwords/

// Use your WordPress login, such as "admin", not the application name.
CkHttp_putLogin(http,'wp_username');
// Use the application password, such as "Nths RwVH eDJ4 weNZ orMN jabq"
CkHttp_putPassword(http,'app_password');
CkHttp_putBasicAuth(http,True);

req := CkHttpRequest_Create();
CkHttpRequest_putHttpVerb(req,'POST');

// Use the Content-Type that corresponds to the type of file you are uploading.

// WordPress supports uploading the following file types:

// Images
// 
//     .jpg  (image/jpg)
//     .jpeg  (image/jpeg)
//     .png  (image/png)
//     .gif  (image/gif)
//     .ico (image/x-icon)
// 
// Documents
// 
//     .pdf (applicatin/pdf)
//     .doc, .docx (application/msword)
//     .ppt, .pptx, .pps, .ppsx (application/mspowerpoint)
//     .odt 
//     .xls, .xlsx (application/msexcel)
//     .psd (??? image/vnd.adobe.photoshop,application/x-photoshop,application/photoshop,application/psd,image/psd)
// 
// Audio
// 
//     .mp3 (audio/mpeg)
//     .m4a
//     .ogg
//     .wav (audio/wav)
// 
// Video
// 
//     .mp4, .m4v (video/mp4)
//     .mov (video/quicktime)
//     .wmv (video/x-ms-wmv)
//     .avi (video/avi)
//     .mpg (video/mpeg)
//     .ogv 
//     .3gp 
//     .3g2 

CkHttpRequest_putContentType(req,'image/jpg');
CkHttpRequest_putPath(req,'/wp-json/wp/v2/media');

success := CkHttpRequest_LoadBodyFromFile(req,'qa_data/jpg/starfish.jpg');
if (success = False) then
  begin
    Memo1.Lines.Add(CkHttpRequest__lastErrorText(req));
    Exit;
  end;
CkHttpRequest_AddHeader(req,'Content-Disposition','attachment; filename=starfish.jpg');

CkHttpRequest_AddHeader(req,'Expect','100-continue');

resp := CkHttp_SynchronousRequest(http,'www.yourserver.com',443,True,req);
if (CkHttp_getLastMethodSuccess(http) <> True) then
  begin
    Memo1.Lines.Add(CkHttp__lastErrorText(http));
    Exit;
  end;

Memo1.Lines.Add('HTTP response status: ' + IntToStr(CkHttpResponse_getStatusCode(resp)));

jsonResponse := CkJsonObject_Create();
CkJsonObject_Load(jsonResponse,CkHttpResponse__bodyStr(resp));
CkHttpResponse_Dispose(resp);

CkJsonObject_putEmitCompact(jsonResponse,False);
Memo1.Lines.Add(CkJsonObject__emit(jsonResponse));

// Sample JSON response:
// (Sample code for parsing the JSON response is shown below)

// {
//   "id": 1915,
//   "date": "2021-01-19T18:25:01",
//   "date_gmt": "2021-01-20T01:25:01",
//   "guid": {
//     "rendered": "http:\/\/cknotes.com\/wp-content\/uploads\/2021\/01\/starfish.jpg",
//     "raw": "http:\/\/cknotes.com\/wp-content\/uploads\/2021\/01\/starfish.jpg"
//   },
//   "modified": "2021-01-19T18:25:01",
//   "modified_gmt": "2021-01-20T01:25:01",
//   "slug": "starfish",
//   "status": "inherit",
//   "type": "attachment",
//   "link": "https:\/\/cknotes.com\/starfish\/",
//   "title": {
//     "raw": "starfish",
//     "rendered": "starfish"
//   },
//   "author": 1,
//   "comment_status": "closed",
//   "ping_status": "closed",
//   "template": "",
//   "meta": [
//   ],
//   "permalink_template": "https:\/\/cknotes.com\/?attachment_id=1915",
//   "generated_slug": "starfish",
//   "description": {
//     "raw": "",
//     "rendered": "<p class=\"attachment\"><a href='https:\/\/cknotes.com\/wp-content\/uploads\/2021\/01\/starfish.jpg'><img width=\"120\" height=\"120\" src=\"https:\/\/cknotes.com\/wp-content\/uploads\/2021\/01\/starfish.jpg\" class=\"attachment-medium size-medium\" alt=\"\" loading=\"lazy\" srcset=\"http:\/\/cknotes.com\/wp-content\/uploads\/2021\/01\/starfish.jpg 120w, http:\/\/cknotes.com\/wp-content\/uploads\/2021\/01\/starfish-100x100.jpg 100w\" sizes=\"(max-width: 120px) 100vw, 120px\" \/><\/a><\/p>\n"
//   },
//   "caption": {
//     "raw": "",
//     "rendered": ""
//   },
//   "alt_text": "",
//   "media_type": "image",
//   "mime_type": "image\/jpeg",
//   "media_details": {
//     "width": 120,
//     "height": 120,
//     "file": "2021\/01\/starfish.jpg",
//     "sizes": {
//       "woocommerce_gallery_thumbnail": {
//         "file": "starfish-100x100.jpg",
//         "width": 100,
//         "height": 100,
//         "mime_type": "image\/jpeg",
//         "source_url": "https:\/\/cknotes.com\/wp-content\/uploads\/2021\/01\/starfish-100x100.jpg"
//       },
//       "shop_thumbnail": {
//         "file": "starfish-100x100.jpg",
//         "width": 100,
//         "height": 100,
//         "mime_type": "image\/jpeg",
//         "source_url": "https:\/\/cknotes.com\/wp-content\/uploads\/2021\/01\/starfish-100x100.jpg"
//       },
//       "full": {
//         "file": "starfish.jpg",
//         "width": 120,
//         "height": 120,
//         "mime_type": "image\/jpeg",
//         "source_url": "https:\/\/cknotes.com\/wp-content\/uploads\/2021\/01\/starfish.jpg"
//       }
//     },
//     "image_meta": {
//       "aperture": "0",
//       "credit": "",
//       "camera": "",
//       "caption": "",
//       "created_timestamp": "0",
//       "copyright": "",
//       "focal_length": "0",
//       "iso": "0",
//       "shutter_speed": "0",
//       "title": "",
//       "orientation": "0",
//       "keywords": [
//       ]
//     }
//   },
//   "post": null,
//   "source_url": "https:\/\/cknotes.com\/wp-content\/uploads\/2021\/01\/starfish.jpg",
//   "missing_image_sizes": [
//   ],
//   "_links": {
//     "self": [
//       {
//         "href": "https:\/\/cknotes.com\/wp-json\/wp\/v2\/media\/1915"
//       }
//     ],
//     "collection": [
//       {
//         "href": "https:\/\/cknotes.com\/wp-json\/wp\/v2\/media"
//       }
//     ],
//     "about": [
//       {
//         "href": "https:\/\/cknotes.com\/wp-json\/wp\/v2\/types\/attachment"
//       }
//     ],
//     "author": [
//       {
//         "embeddable": true,
//         "href": "https:\/\/cknotes.com\/wp-json\/wp\/v2\/users\/1"
//       }
//     ],
//     "replies": [
//       {
//         "embeddable": true,
//         "href": "https:\/\/cknotes.com\/wp-json\/wp\/v2\/comments?post=1915"
//       }
//     ],
//     "wp:action-unfiltered-html": [
//       {
//         "href": "https:\/\/cknotes.com\/wp-json\/wp\/v2\/media\/1915"
//       }
//     ],
//     "wp:action-assign-author": [
//       {
//         "href": "https:\/\/cknotes.com\/wp-json\/wp\/v2\/media\/1915"
//       }
//     ],
//     "curies": [
//       {
//         "name": "wp",
//         "href": "https:\/\/api.w.org\/{rel}",
//         "templated": true
//       }
//     ]
//   }
// }

// Sample code for parsing the JSON response...
// Use the following online tool to generate parsing code from sample JSON:
// Generate Parsing Code from JSON

date_gmt := CkDtObj_Create();

id := CkJsonObject_IntOf(jsonResponse,'id');
date := CkJsonObject__stringOf(jsonResponse,'date');
CkJsonObject_DtOf(jsonResponse,'date_gmt',False,date_gmt);
guidRendered := CkJsonObject__stringOf(jsonResponse,'guid.rendered');
guidRaw := CkJsonObject__stringOf(jsonResponse,'guid.raw');
modified := CkJsonObject__stringOf(jsonResponse,'modified');
modified_gmt := CkJsonObject__stringOf(jsonResponse,'modified_gmt');
slug := CkJsonObject__stringOf(jsonResponse,'slug');
status := CkJsonObject__stringOf(jsonResponse,'status');
v_type := CkJsonObject__stringOf(jsonResponse,'type');
link := CkJsonObject__stringOf(jsonResponse,'link');
titleRaw := CkJsonObject__stringOf(jsonResponse,'title.raw');
titleRendered := CkJsonObject__stringOf(jsonResponse,'title.rendered');
author := CkJsonObject_IntOf(jsonResponse,'author');
comment_status := CkJsonObject__stringOf(jsonResponse,'comment_status');
ping_status := CkJsonObject__stringOf(jsonResponse,'ping_status');
template := CkJsonObject__stringOf(jsonResponse,'template');
permalink_template := CkJsonObject__stringOf(jsonResponse,'permalink_template');
generated_slug := CkJsonObject__stringOf(jsonResponse,'generated_slug');
descriptionRaw := CkJsonObject__stringOf(jsonResponse,'description.raw');
descriptionRendered := CkJsonObject__stringOf(jsonResponse,'description.rendered');
captionRaw := CkJsonObject__stringOf(jsonResponse,'caption.raw');
captionRendered := CkJsonObject__stringOf(jsonResponse,'caption.rendered');
alt_text := CkJsonObject__stringOf(jsonResponse,'alt_text');
media_type := CkJsonObject__stringOf(jsonResponse,'media_type');
mime_type := CkJsonObject__stringOf(jsonResponse,'mime_type');
media_detailsWidth := CkJsonObject_IntOf(jsonResponse,'media_details.width');
media_detailsHeight := CkJsonObject_IntOf(jsonResponse,'media_details.height');
media_detailsFile := CkJsonObject__stringOf(jsonResponse,'media_details.file');
media_detailsSizesWoocommerce_gallery_thumbnailFile := CkJsonObject__stringOf(jsonResponse,'media_details.sizes.woocommerce_gallery_thumbnail.file');
media_detailsSizesWoocommerce_gallery_thumbnailWidth := CkJsonObject_IntOf(jsonResponse,'media_details.sizes.woocommerce_gallery_thumbnail.width');
media_detailsSizesWoocommerce_gallery_thumbnailHeight := CkJsonObject_IntOf(jsonResponse,'media_details.sizes.woocommerce_gallery_thumbnail.height');
media_detailsSizesWoocommerce_gallery_thumbnailMime_type := CkJsonObject__stringOf(jsonResponse,'media_details.sizes.woocommerce_gallery_thumbnail.mime_type');
media_detailsSizesWoocommerce_gallery_thumbnailSource_url := CkJsonObject__stringOf(jsonResponse,'media_details.sizes.woocommerce_gallery_thumbnail.source_url');
media_detailsSizesShop_thumbnailFile := CkJsonObject__stringOf(jsonResponse,'media_details.sizes.shop_thumbnail.file');
media_detailsSizesShop_thumbnailWidth := CkJsonObject_IntOf(jsonResponse,'media_details.sizes.shop_thumbnail.width');
media_detailsSizesShop_thumbnailHeight := CkJsonObject_IntOf(jsonResponse,'media_details.sizes.shop_thumbnail.height');
media_detailsSizesShop_thumbnailMime_type := CkJsonObject__stringOf(jsonResponse,'media_details.sizes.shop_thumbnail.mime_type');
media_detailsSizesShop_thumbnailSource_url := CkJsonObject__stringOf(jsonResponse,'media_details.sizes.shop_thumbnail.source_url');
media_detailsSizesFullFile := CkJsonObject__stringOf(jsonResponse,'media_details.sizes.full.file');
media_detailsSizesFullWidth := CkJsonObject_IntOf(jsonResponse,'media_details.sizes.full.width');
media_detailsSizesFullHeight := CkJsonObject_IntOf(jsonResponse,'media_details.sizes.full.height');
media_detailsSizesFullMime_type := CkJsonObject__stringOf(jsonResponse,'media_details.sizes.full.mime_type');
media_detailsSizesFullSource_url := CkJsonObject__stringOf(jsonResponse,'media_details.sizes.full.source_url');
media_detailsImage_metaAperture := CkJsonObject__stringOf(jsonResponse,'media_details.image_meta.aperture');
media_detailsImage_metaCredit := CkJsonObject__stringOf(jsonResponse,'media_details.image_meta.credit');
media_detailsImage_metaCamera := CkJsonObject__stringOf(jsonResponse,'media_details.image_meta.camera');
media_detailsImage_metaCaption := CkJsonObject__stringOf(jsonResponse,'media_details.image_meta.caption');
media_detailsImage_metaCreated_timestamp := CkJsonObject__stringOf(jsonResponse,'media_details.image_meta.created_timestamp');
media_detailsImage_metaCopyright := CkJsonObject__stringOf(jsonResponse,'media_details.image_meta.copyright');
media_detailsImage_metaFocal_length := CkJsonObject__stringOf(jsonResponse,'media_details.image_meta.focal_length');
media_detailsImage_metaIso := CkJsonObject__stringOf(jsonResponse,'media_details.image_meta.iso');
media_detailsImage_metaShutter_speed := CkJsonObject__stringOf(jsonResponse,'media_details.image_meta.shutter_speed');
media_detailsImage_metaTitle := CkJsonObject__stringOf(jsonResponse,'media_details.image_meta.title');
media_detailsImage_metaOrientation := CkJsonObject__stringOf(jsonResponse,'media_details.image_meta.orientation');
post := CkJsonObject__stringOf(jsonResponse,'post');
source_url := CkJsonObject__stringOf(jsonResponse,'source_url');
i := 0;
count_i := CkJsonObject_SizeOfArray(jsonResponse,'meta');
while i < count_i do
  begin
    CkJsonObject_putI(jsonResponse,i);
    i := i + 1;
  end;

i := 0;
count_i := CkJsonObject_SizeOfArray(jsonResponse,'media_details.image_meta.keywords');
while i < count_i do
  begin
    CkJsonObject_putI(jsonResponse,i);
    i := i + 1;
  end;

i := 0;
count_i := CkJsonObject_SizeOfArray(jsonResponse,'missing_image_sizes');
while i < count_i do
  begin
    CkJsonObject_putI(jsonResponse,i);
    i := i + 1;
  end;

i := 0;
count_i := CkJsonObject_SizeOfArray(jsonResponse,'_links.self');
while i < count_i do
  begin
    CkJsonObject_putI(jsonResponse,i);
    href := CkJsonObject__stringOf(jsonResponse,'_links.self[i].href');
    i := i + 1;
  end;

i := 0;
count_i := CkJsonObject_SizeOfArray(jsonResponse,'_links.collection');
while i < count_i do
  begin
    CkJsonObject_putI(jsonResponse,i);
    href := CkJsonObject__stringOf(jsonResponse,'_links.collection[i].href');
    i := i + 1;
  end;

i := 0;
count_i := CkJsonObject_SizeOfArray(jsonResponse,'_links.about');
while i < count_i do
  begin
    CkJsonObject_putI(jsonResponse,i);
    href := CkJsonObject__stringOf(jsonResponse,'_links.about[i].href');
    i := i + 1;
  end;

i := 0;
count_i := CkJsonObject_SizeOfArray(jsonResponse,'_links.author');
while i < count_i do
  begin
    CkJsonObject_putI(jsonResponse,i);
    embeddable := CkJsonObject_BoolOf(jsonResponse,'_links.author[i].embeddable');
    href := CkJsonObject__stringOf(jsonResponse,'_links.author[i].href');
    i := i + 1;
  end;

i := 0;
count_i := CkJsonObject_SizeOfArray(jsonResponse,'_links.replies');
while i < count_i do
  begin
    CkJsonObject_putI(jsonResponse,i);
    embeddable := CkJsonObject_BoolOf(jsonResponse,'_links.replies[i].embeddable');
    href := CkJsonObject__stringOf(jsonResponse,'_links.replies[i].href');
    i := i + 1;
  end;

i := 0;
count_i := CkJsonObject_SizeOfArray(jsonResponse,'_links.wp:action-unfiltered-html');
while i < count_i do
  begin
    CkJsonObject_putI(jsonResponse,i);
    href := CkJsonObject__stringOf(jsonResponse,'_links.wp:action-unfiltered-html[i].href');
    i := i + 1;
  end;

i := 0;
count_i := CkJsonObject_SizeOfArray(jsonResponse,'_links.wp:action-assign-author');
while i < count_i do
  begin
    CkJsonObject_putI(jsonResponse,i);
    href := CkJsonObject__stringOf(jsonResponse,'_links.wp:action-assign-author[i].href');
    i := i + 1;
  end;

i := 0;
count_i := CkJsonObject_SizeOfArray(jsonResponse,'_links.curies');
while i < count_i do
  begin
    CkJsonObject_putI(jsonResponse,i);
    name := CkJsonObject__stringOf(jsonResponse,'_links.curies[i].name');
    href := CkJsonObject__stringOf(jsonResponse,'_links.curies[i].href');
    templated := CkJsonObject_BoolOf(jsonResponse,'_links.curies[i].templated');
    i := i + 1;
  end;

CkHttp_Dispose(http);
CkHttpRequest_Dispose(req);
CkJsonObject_Dispose(jsonResponse);
CkDtObj_Dispose(date_gmt);

end;