Initial Release for BetterStack Logger (#1)

* Basic logging in place

* Prepping for release

* Updated README.md

* Added readme.txt

Author: millertchris

README.md

@@ -0,0 +1,99 @@
+# BetterStack Logger
+
+BetterStack Logger is a powerful WordPress plugin that allows you to seamlessly integrate BetterStack with your WordPress site. Enhance your logging capabilities by sending error messages, post changes, user actions, and more directly to BetterStack. With easy configuration and flexible logging functions, this plugin is an essential tool for developers and site administrators looking to keep track of their site's activities.
+
+## Features
+
+- **Error Logging:** Capture and log WordPress errors directly to BetterStack.
+- **User Action Logging:** Log important user actions such as logins, registrations, and profile updates.
+- **Post Changes:** Monitor post creation, updates, and deletions.
+- **Plugin and Theme Activity:** Log plugin activations/deactivations and theme switches.
+- **Customizable Logging:** Use helper functions to log custom messages from anywhere in your codebase.
+- **Settings Page:** Easily configure the API key, enable or disable specific logging features via the WordPress admin panel.
+- **Support for `wp-config.php`:** Define your BetterStack API key in `wp-config.php` for additional security.
+
+## Installation
+
+### From Your WordPress Dashboard
+
+1. Navigate to `Plugins` -> `Add New`.
+2. Search for `BetterStack Logger`.
+3. Click `Install Now`.
+4. Activate the plugin.
+5. Go to `Tools` -> `BetterStack Logger Settings` to configure the plugin.
+
+### Manual Installation
+
+1. Download the plugin from the [Plugin Releases](https://github.com/prolific-digital/betterstack-logger/releases).
+2. Upload the `betterstack-logger` directory to the `/wp-content/plugins/` directory.
+3. Activate the plugin through the `Plugins` menu in WordPress.
+4. Go to `Tools` -> `BetterStack Logger Settings` to configure the plugin.
+
+## Configuration
+
+### API Key
+
+To log messages to BetterStack, you need to set up your API key:
+
+1. Go to `Tools` -> `BetterStack Logger Settings`.
+2. Enter your BetterStack API key in the `API Key` field.
+3. Optionally, define the API key in your `wp-config.php` file using `BETTERSTACK_API_KEY`.
+
+### Logging Options
+
+- **Enable Error Logging:** Toggle to capture WordPress errors.
+- **Enable Event Logging:** Toggle to log user actions, post changes, and more.
+
+## Usage
+
+### Logging Custom Messages
+
+Use the following functions to log messages from anywhere in your code:
+
+```php
+// Log a custom message
+better_error_log('This is a custom error message.');
+
+// Shorter version
+b_log('This is a quick log message.');
+```
+
+### Example:
+
+```php
+function my_custom_function() {
+    // Perform some task
+    // ...
+
+    // Log a message
+    better_error_log('Task completed successfully.');
+}
+
+add_action('init', 'my_custom_function');
+```
+
+### Available Functions
+
+- `better_error_log($message)`: Logs a custom message to BetterStack.
+- `b_log($message)`: Shorthand function to log a custom message to BetterStack.
+
+## Frequently Asked Questions
+
+Can I define the API key in `wp-config.php`?
+
+Yes! For added security, you can define your API key in `wp-config.php` using:
+
+```php
+define('BETTERSTACK_API_KEY', 'your-api-key-here');
+```
+
+What types of events can I log with BetterStack Logger?
+
+You can log errors, user actions (e.g., logins, registrations), post changes (e.g., creation, updates, deletions), plugin activations/deactivations, theme switches, and custom messages.
+
+## Support
+
+If you need help or have any questions, feel free to reach out to us:
+
+- Visit our [Support Page](https://prolificdigital.notion.site/BetterStack-Logger-c0cc4526efd049c09b77965bf3ecc28e)
+- Email us at [email protected]

betterstack-logger.php

@@ -0,0 +1,64 @@
+<?php
+/*
+Plugin Name: BetterStack Logger
+Plugin URI:  https://prolificdigital.com
+Description: Seamlessly integrate with BetterStack to log messages directly from your WordPress site. Enhance your logging capabilities with ease and precision.
+Short Description: Seamlessly integrate with BetterStack to log messages directly from your WordPress site.
+Tags: betterstack, logger, logging, error, errors, debug, debugging, log, logs, monitoring, monitoring, betterstack logger, betterstack logging, betterstack error logging, betterstack error logger, betterstack debug logging, betterstack debug logger
+Version: 1.0.0
+Requires at least: 6.0
+Requires PHP: 8.0
+Tested up to: 6.6
+Author: Prolific Digital
+Author URI: https://prolificdigital.com
+License: GPLv2 or later
+License URI: https://www.gnu.org/licenses/gpl-2.0.html
+Text Domain: betterstack-logger
+
+*/
+
+if (!defined('WPINC')) {
+  die;
+}
+
+require_once plugin_dir_path(__FILE__) . 'includes/BetterStackLogger.php';
+
+// Create a global instance of the BetterStackLogger class
+global $betterstack_logger;
+$betterstack_logger = new BetterStackLogger();
+
+/**
+ * Log an error message using BetterStackLogger.
+ *
+ * This function allows developers to easily log messages to BetterStack
+ * from anywhere in the codebase by calling better_error_log($message).
+ *
+ * @param string $message The message to log.
+ */
+if (!function_exists('better_error_log')) {
+  function better_error_log($message) {
+    global $betterstack_logger;
+
+    if ($betterstack_logger instanceof BetterStackLogger) {
+      $betterstack_logger->log_error($message);
+    }
+  }
+}
+
+/**
+ * Log an error message using BetterStackLogger.
+ *
+ * This function provides a shorthand way for developers to log messages to BetterStack
+ * from anywhere in the codebase by calling b_log($message).
+ *
+ * @param string $message The message to log.
+ */
+if (!function_exists('b_log')) {
+  function b_log($message) {
+    global $betterstack_logger;
+
+    if ($betterstack_logger instanceof BetterStackLogger) {
+      $betterstack_logger->log_error($message);
+    }
+  }
+}