{"id":29867242,"url":"https://github.com/techartdev/woocommerce_stats","last_synced_at":"2025-10-30T02:34:05.689Z","repository":{"id":265684452,"uuid":"896475710","full_name":"techartdev/woocommerce_stats","owner":"techartdev","description":"WooCommerce Stats for Home Assistant","archived":false,"fork":false,"pushed_at":"2024-11-30T14:08:47.000Z","size":12,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-11-30T14:27:22.879Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/techartdev.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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-11-30T13:16:00.000Z","updated_at":"2024-11-30T14:08:50.000Z","dependencies_parsed_at":"2024-11-30T14:27:32.877Z","dependency_job_id":"ba421512-5bc1-4a62-81b0-893e1effa6b9","html_url":"https://github.com/techartdev/woocommerce_stats","commit_stats":null,"previous_names":["techartdev/woocommerce_stats"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/techartdev/woocommerce_stats","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/techartdev%2Fwoocommerce_stats","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/techartdev%2Fwoocommerce_stats/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/techartdev%2Fwoocommerce_stats/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/techartdev%2Fwoocommerce_stats/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/techartdev","download_url":"https://codeload.github.com/techartdev/woocommerce_stats/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/techartdev%2Fwoocommerce_stats/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":267875056,"owners_count":24158767,"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","status":"online","status_checked_at":"2025-07-30T02:00:09.044Z","response_time":70,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":"2025-07-30T13:22:56.070Z","updated_at":"2025-10-30T02:34:00.660Z","avatar_url":"https://github.com/techartdev.png","language":"Python","readme":"# WooCommerce Stats for Home Assistant\n\nA custom Home Assistant integration that uses the WooCommerce API to fetch and display basic statistics for your WooCommerce store, such as total sales, orders, and customers.\n\n---\n\n## Features\n- Fetch live WooCommerce statistics using the WooCommerce API.\n- Displays data in Home Assistant as sensors.\n- Supports custom Lovelace dashboard cards for visualization.\n- Easily configurable through the Home Assistant UI.\n\n---\n\n## Installation\n\n### HACS (Home Assistant Community Store)\n1. Open HACS in your Home Assistant instance.\n2. Go to **Integrations** → Click on the **+ Explore \u0026 Download Repositories** button.\n3. Add this repository: `https://github.com/techartdev/woocommerce_stats`.\n4. Install the \"WooCommerce Stats\" integration.\n5. Restart Home Assistant.\n\n### Manual Installation\n1. Download the repository as a ZIP file.\n2. Extract the ZIP and copy the `woocommerce_stats` folder to your Home Assistant `custom_components` directory.\n3. Restart Home Assistant.\n\n---\n\n## Configuration\n\n### Integration Setup via UI\n1. After installation, go to **Settings → Devices \u0026 Services → Add Integration**.\n2. Search for **WooCommerce Stats**.\n3. Enter the following:\n   - Your WooCommerce store URL (e.g., `https://your-woocommerce-store.com`).\n   - Your API **Consumer Key** and **Consumer Secret**.\n4. Complete the setup and restart Home Assistant if necessary.\n\n---\n\n## Available Sensors\nThe following sensors will be created automatically after setup:\n- `sensor.total_sales`: Today total sales from the WooCommerce store.\n- `sensor.total_orders`: Today total number of orders.\n- `sensor.total_items`: Today total number of items sold.\n- `sensor.total_tax`: Today total tax collected.\n- `sensor.total_shipping`: Today total shipping charges.\n- `sensor.total_customers`: Today total number of customers registered.\n- `sensor.orders_pending`: Total number of pending orders.\n- `orders_processing`: Total number of processing orders.\n- `orders_completed`: Total number of completed orders.\n- `orders_cancelled`: Total number of canceled orders.\n- `orders_refunded`: Total number of refunded orders.\n- `orders_failed`: Total number of failed orders.\n\n---\n\n## Example Dashboard Cards\n\n### Simple Table\nAdd the following YAML to your Lovelace dashboard for a table view:\n\n```yaml\ntype: entities\ntitle: WooCommerce Live Stats\nentities:\n  - entity: sensor.total_sales\n    name: Total Sales\n  - entity: sensor.total_orders\n    name: Total Orders\n  - entity: sensor.total_items\n    name: Total Items Sold\n  - entity: sensor.total_tax\n    name: Total Tax\n  - entity: sensor.total_shipping\n    name: Total Shipping\n  - entity: sensor.total_customers\n    name: Total Customers\n  - entity: sensor.orders_processing\n    name: Processing Orders\n```\n\n### Chart (ApexCharts)\nTo visualize the data as a chart, install the **ApexCharts** card via HACS and use this configuration:\n\n```yaml\ntype: custom:apexcharts-card\nheader:\n  title: WooCommerce Stats\nseries:\n  - entity: sensor.total_sales\n    name: Total Sales\n  - entity: sensor.total_orders\n    name: Total Orders\n  - entity: sensor.total_items\n    name: Items Sold\n  - entity: sensor.orders_processing\n    name: Processing Orders\nupdate_interval: 10min\n```\n\n---\n\n## Troubleshooting\nIf you encounter issues:\n1. Check the Home Assistant logs for any error messages:\n   - Go to **Settings → System → Logs**.\n2. Verify your WooCommerce API credentials:\n   - Make sure your **Consumer Key** and **Consumer Secret** have read permissions.\n3. Ensure your WooCommerce store URL is correct and accessible via HTTPS.\n4. If you're using Cloudflare or a security plugin, allowlist your Home Assistant server's IP or bypass security checks for the WooCommerce REST API.\n\n---\n\n## License\nThis project is licensed under the MIT License.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftechartdev%2Fwoocommerce_stats","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftechartdev%2Fwoocommerce_stats","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftechartdev%2Fwoocommerce_stats/lists"}