Add an image to TXP using PHP

To add an image via the Textpattern API, you will need to make a POST request to the "image" endpoint, including the image file and any relevant metadata in the request body. The specific steps and required parameters will depend on the version of the Textpattern API you are using, as well as the programming language and library you are using to make the API call.

You should check the Textpattern API documentation for more information on how to properly format the request and the required parameters.

> What's a PHP example of adding an image to a Textpattern site?

Here's an example of how you might use PHP to add an image to a Textpattern site using the API:

~~~
<?php
// Use the cURL library to make the API request
$curl = curl_init();

// Set the API endpoint URL and any required headers
curl_setopt_array($curl, array(
  CURLOPT_URL => "https://example.com/textpattern/api/image",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => array('image' => new CURLFile('path/to/image.jpg', 'image/jpeg')),
  CURLOPT_HTTPHEADER => array(
    "Content-Type: multipart/form-data",
    "X-TX-Auth: YOUR_AUTH_TOKEN"
  ),
));

// Execute the API request and capture the response
$response = curl_exec($curl);
$err = curl_error($curl);

// Close the cURL connection
curl_close($curl);

// Check for errors and process the response
if ($err) {
  echo "cURL Error #:" . $err;
} else {
  $data = json_decode($response, true);
  if (isset($data['error'])) {
    echo $data['error'];
  } else {
    echo "Image uploaded successfully. ID:" . $data['id'];
  }
}

~~~

In this example, the path/to/image.jpg should be replaced with the actual file path of the image you want to upload, and YOUR_AUTH_TOKEN should be replaced with the authentication token you have been provided.

This example uses the cURL library to make the API request, with the image file and the X-TX-Auth header set in the CURLOPT_POSTFIELDS and CURLOPT_HTTPHEADER options, respectively.

The response of the API will be a JSON object which can be decoded and processed as shown in the example.

Please note that this is just an example, you may need to adjust it to match your specific requirements and the version of Textpattern you are using.