{"id":13549322,"url":"https://github.com/rollbar/rollbar-php-wordpress","last_synced_at":"2025-04-02T22:31:47.140Z","repository":{"id":25562994,"uuid":"103796631","full_name":"rollbar/rollbar-php-wordpress","owner":"rollbar","description":"Official WordPress plugin from Rollbar, Inc.","archived":false,"fork":true,"pushed_at":"2024-12-20T20:03:00.000Z","size":10732,"stargazers_count":15,"open_issues_count":16,"forks_count":20,"subscribers_count":14,"default_branch":"master","last_synced_at":"2024-12-20T21:22:47.793Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://rollbar.com/","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":"yffaffy/rollbar","license":"gpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/rollbar.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-09-17T02:11:53.000Z","updated_at":"2024-12-20T20:03:01.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/rollbar/rollbar-php-wordpress","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rollbar%2Frollbar-php-wordpress","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rollbar%2Frollbar-php-wordpress/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rollbar%2Frollbar-php-wordpress/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rollbar%2Frollbar-php-wordpress/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/rollbar","download_url":"https://codeload.github.com/rollbar/rollbar-php-wordpress/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246905200,"owners_count":20852812,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-08-01T12:01:20.655Z","updated_at":"2025-04-02T22:31:43.271Z","avatar_url":"https://github.com/rollbar.png","language":"PHP","funding_links":[],"categories":["PHP"],"sub_categories":[],"readme":"# Rollbar for WordPress\n[![Plugin Version](https://img.shields.io/wordpress/plugin/v/rollbar.svg)](https://wordpress.org/plugins/rollbar/) [![WordPress Version Compatibility](https://img.shields.io/wordpress/v/rollbar.svg)](https://wordpress.org/plugins/rollbar/) [![Downloads](https://img.shields.io/wordpress/plugin/dt/rollbar.svg)](https://wordpress.org/plugins/rollbar/) [![Rating](https://img.shields.io/wordpress/plugin/r/rollbar.svg)](https://wordpress.org/plugins/rollbar/)\n\nRollbar full-stack error tracking for WordPress\n\nThe full documentation is available [here](https://docs.rollbar.com/v1.0.0/docs/wordpress).\n\n## Description\nRollbar collects errors that happen in your application, notifies you, and analyzes them so you can debug and fix them.\n\nThis plugin integrates Rollbar into your WordPress installation.\n\nFind out [how Rollbar can help you decrease development and maintenance costs](https://rollbar.com/features/).\n\nSee [real companies improving their development workflow thanks to Rollbar](https://rollbar.com/customers/).\n\n[Official WordPress.org Plugin](https://wordpress.org/plugins/rollbar/)\n\n## Installation\n\n### Through [WordPress Plugin directory](https://wordpress.org/plugins/rollbar/)\n\nThe easiest way to install the plugin is from the WordPress Plugin directory. If you have an existing WordPress installation and you want to add Rollbar:\n\n1. In your WordPress administration panel go to `Plugins` → `Add New`.\n2. Search for \"Rollbar\" and find `Rollbar` by Rollbar in the search results.\n3. Click `Install Now` next to the `Rollbar` plugin.\n4. In `Plugins` → `Installed plugins` find `Rollbar` and click `Activate` underneath.\n5. Log into your [Rollbar account dashboard](https://rollbar.com/login/):\n   1. Go to `Settings` → `Project Access Tokens`.\n   2. Copy the token value under `post_client_item` and `post_server_item`.\n6. In WordPress, navigate to `Settings` → `Rollbar`:\n   1. Enable `PHP error logging` and/or `Javascript error logging` depending on your needs.\n   2. Paste the tokens you copied in step 7 in `Access Token` section.\n   3. Provide the name of your environment in `Environment`. By default, the environment will be taken from `WP_ENV` environment variable if it's set otherwise it's blank. We recommend to fill this out either with `development` or `production`.\n   4. Pick a minimum logging level. Only errors at that or higher level will be reported. For reference: [PHP Manual: Predefined Error Constants](http://php.net/manual/en/errorfunc.constants.php).\n   5. Click `Save Changes`.\n\n**Warning**: This installation method might not be suitable for complex WordPress projects. The plugin installed this way will be self-contained and include all of the required dependencies for itself and `rollbar/rollbar-php` library. In complex projects, this might lead to version conflicts between dependencies and other plugins/packages. If this is an issue in your project, we recommend the \"Advanced\" installation method. For more information why this might be important for you, read [Using Composer with WordPress](https://roots.io/using-composer-with-wordpress/).\n\n### Through [wpackagist](https://wpackagist.org/) (if you manage your project with Composer) *recommended*\n\nThis is a recommended way to install Rollbar plugin for advanced projects. This way ensures the plugin and all of its' dependencies are managed by Composer.\n\n1. If your WordPress project is not managed with Composer yet, we suggest looking into upgrading your WordPress: [Using Composer with WordPress](https://roots.io/using-composer-with-wordpress/).\n2. In your `composer.json` add `wpackagist-plugin/rollbar` to your `require` section, i.e.:\n```json\n  \"require\": {\n    \"php\": \"\u003e=5.5\",\n    ...,\n    \"wpackagist-plugin/rollbar\": \"*\"\n  }\n```\n3. Issue command `composer install` in the root directory of your WordPress project.\n4. Go to step #4 above.\n\n## Help / Support\n\nIf you run into any issues, please email us at [support@rollbar.com](mailto:support@rollbar.com)\n\nFor bug reports, please [open an issue on GitHub](https://github.com/rollbar/rollbar-php-wordpress/issues/new).\n\n## Special thanks\n\nThe original author of this package is [@flowdee](https://twitter.com/flowdee/). This is a fork and continuation of his efforts.\n\n## Contributing\n\n1. Fork it\n2. Create your feature branch (`git checkout -b my-new-feature`)\n3. Commit your changes (`git commit -am 'Added some feature'`)\n4. Push to the branch (`git push origin my-new-feature`)\n5. Verify your commit passes the code standards enforced by [Codacy](https://www.codacy.com).\n5. Create new Pull Request\n\n## Testing\n\nIn order to run the tests, you will need to install the dependencies for [@wordpress/env](https://www.npmjs.com/package/@wordpress/env) including Node.js, git, and docker.\n\n1. npm install\n2. npm run test\nYou can set the `WP_ENV_PHP_VERSION` enviormental variable to test with different versions of PHP.  If you are changing the version, you can do so by running `WP_ENV_PHP_VERSION=\"8.2\" npm run wp-env start -- --update` and setting the enviornmental variable based on \n\n## Tagging\n\nThis is only for contributors with committer access:\n\n1. Bump the plugin version.\n    1. Bump the plugin version in `readme.txt` under `Stable tag`.\n    2. Add record in the `Changelog` section of the `readme.txt`.\n    3. Add record in the `Upgrade Notice` section of the `readme.txt`.\n    4. Bump the plugin version in `rollbar-php-wordpress.php` in the `Version:` comment.\n    5. Bump the plugin version in `src/Plugin.php` in the `\\Rollbar\\Wordpress\\Plugin::VERSION` constant.\n    5. Add and commit the changes you made to bump the plugin version: `git add readme.txt rollbar-php-wordpress.php src/Plugin.php \u0026\u0026 git commit -m\"Bump version to v[version number]\"`\n    6. Bump versions of the JS and CSS files versions in Settings.php class to force refresh of those assets on users' installations.\n    7. `git push origin master`\n2. Tag the new version from the `master` branch and push upstream with `git tag v[version number] \u0026\u0026 git push --tags`.\n3. Publish a new release on [GitHub](https://github.com/rollbar/rollbar-php-wordpress/releases).\n4. Update the WordPress Plugin Directory Subversion Repository.\n    1. Fetch the latest contents of Subversion repo with `svn update`.\n    2. Remove the contents of `trunk/` with `rm -Rf trunk`.\n    3. Update the contents of `trunk/` with a clone of the tag you created in step 2.\n        2. `git clone https://github.com/rollbar/rollbar-php-wordpress.git trunk`\n        3. `cd trunk \u0026\u0026 git checkout tags/v[version number] \u0026\u0026 cd ..`\n        4. `rm -Rf trunk/.git`\n        5. `svn add trunk --force`\n        6. `svn commit -m\"Sync with GitHub repo\"`\n    4. Create the Subversion tag: `svn copy https://plugins.svn.wordpress.org/rollbar/trunk https://plugins.svn.wordpress.org/rollbar/tags/[version number] -m\"Tag [version number]\"`. Notice the version number in Subversion doesn't include the \"v\" prefix.\n\n## Disclaimer\n\nThis plugin is a community-driven contribution. All rights reserved to Rollbar. \n\n[![Rollbar](https://d26gfdfi90p7cf.cloudfront.net/rollbar-badge.144534.o.png)](https://rollbar.com/)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frollbar%2Frollbar-php-wordpress","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frollbar%2Frollbar-php-wordpress","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frollbar%2Frollbar-php-wordpress/lists"}