Certainly! Here's the updated README.md for the Simple Otel plugin:

Simple Otel Plugin Installation

Installation

To install or update the Simple Otel plugin, run the following command from the root of your WordPress HTML directory:

curl -sSL https://git.nixc.us/colin/SimpleOtel/raw/branch/main/install.sh | bash

Enabling the Plugin

After running the install script, you need to activate the plugin. You can do this via the WordPress admin dashboard:

1. Log in to your WordPress admin dashboard.
2. Navigate to Plugins > Installed Plugins.
3. Find Simple Otel in the list and click Activate.

Alternatively, you can activate the plugin using WP-CLI:

wp plugin activate simple-otel --allow-root

What install.sh Does

The install.sh script performs the following actions:

1. Defines the URL for downloading the simple-otel.php file.
2. Creates the target directory (wp-content/plugins/simple-otel) if it doesn't exist.
3. Downloads the simple-otel.php file into the target directory.
4. Downloads and unzips the vendor directory containing pre-installed dependencies.
5. Creates a blank config.php file if it doesn't already exist and provides a template for configuration.
6. Sets the correct permissions for the simple-otel.php and config.php files.
7. Prints a message indicating that the Simple Otel plugin has been installed or updated successfully.

Configuration

After installing the plugin, you can customize its behavior by editing the config.php file located in wp-content/plugins/simple-otel/.

Example config.php

Here is an example configuration for the config.php file:

<?php
// Configuration for Simple Otel plugin
// Add your configurations here

// Set default values using environment variables or fallback to manual configuration
$otel_service_name = getenv('OTEL_SERVICE_NAME') ?: 'default-service-name';
$otel_exporter_otlp_endpoint = getenv('OTEL_EXPORTER_OTLP_ENDPOINT') ?: 'http://localhost:4317';

// Apply configurations
if (isset($GLOBALS['tracer'])) {
    $GLOBALS['tracer']->setAttribute('service.name', $otel_service_name);
    $GLOBALS['tracer']->setAttribute('otel.exporter.otlp.endpoint', $otel_exporter_otlp_endpoint);
}
?>

Explanation

• Service Name: Set the name of the service as it will appear in your observability platform. It uses the OTEL_SERVICE_NAME environment variable if set; otherwise, it defaults to default-service-name.
• OTLP Endpoint: Specify the endpoint where SigNoz is running. It uses the OTEL_EXPORTER_OTLP_ENDPOINT environment variable if set; otherwise, it defaults to http://localhost:4317.

You can add more configuration options as needed. The plugin will include this file and apply the configurations when it initializes.

Additional Information

For more information on how to use and configure the Simple Otel plugin, please refer to the documentation or visit the OpenTelemetry PHP documentation.

By following these instructions, you can set up the Simple Otel plugin with pre-installed dependencies, making it easier for end-users to install and activate the plugin without needing to run Composer themselves.