{"id":17024900,"url":"https://github.com/devatreides/metavel","last_synced_at":"2025-10-24T18:03:14.682Z","repository":{"id":143568677,"uuid":"615895749","full_name":"devatreides/metavel","owner":"devatreides","description":"A simple package to integrate Metabase dashboards and questions to Laravel","archived":false,"fork":false,"pushed_at":"2023-03-19T21:15:10.000Z","size":39,"stargazers_count":21,"open_issues_count":1,"forks_count":2,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-10-14T13:23:53.447Z","etag":null,"topics":["data-visualization","integration","laravel","metabase","php"],"latest_commit_sha":null,"homepage":"","language":"PHP","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/devatreides.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":"2023-03-19T01:40:02.000Z","updated_at":"2024-12-05T20:43:53.000Z","dependencies_parsed_at":null,"dependency_job_id":"e58be06b-6d5a-4ce5-90fe-cfeee91fcbf9","html_url":"https://github.com/devatreides/metavel","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/devatreides/metavel","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devatreides%2Fmetavel","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devatreides%2Fmetavel/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devatreides%2Fmetavel/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devatreides%2Fmetavel/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/devatreides","download_url":"https://codeload.github.com/devatreides/metavel/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devatreides%2Fmetavel/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":280655890,"owners_count":26368250,"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-10-23T02:00:06.710Z","response_time":142,"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":["data-visualization","integration","laravel","metabase","php"],"created_at":"2024-10-14T07:27:21.203Z","updated_at":"2025-10-24T18:03:14.623Z","avatar_url":"https://github.com/devatreides.png","language":"PHP","readme":"\u003cp align=\"center\"\u003e\u003ca href=\"https://github.com/tombenevides\" target=\"_blank\"\u003e\u003cimg src=\"https://banners.beyondco.de/Metavel.png?theme=light\u0026packageManager=composer+require\u0026packageName=tombenevides%2Fmetavel\u0026pattern=architect\u0026style=style_1\u0026description=Simple+way+to+integrate+Metabase+with+Laravel\u0026md=1\u0026showWatermark=0\u0026fontSize=100px\u0026images=chart-pie\" width=\"650\"\u003e\u003c/a\u003e\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/tombenevides/metavel/actions\"\u003e\u003cimg alt=\"Total Downloads\" src=\"https://github.com/tombenevides/metavel/actions/workflows/tests.yml/badge.svg?branch=main\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/tombenevides/metavel/issues\"\u003e\u003cimg alt=\"Issues Open\" src=\"https://img.shields.io/github/issues/tombenevides/metavel\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://packagist.org/packages/tombenevides/metavelr\"\u003e\u003cimg alt=\"Total Downloads\" src=\"https://img.shields.io/packagist/dt/tombenevides/metavel\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://packagist.org/packages/tombenevides/metavel\"\u003e\u003cimg alt=\"Latest Version\" src=\"https://img.shields.io/packagist/v/tombenevides/metavel\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://packagist.org/packages/tombenevides/metavel\"\u003e\u003cimg alt=\"License\" src=\"https://img.shields.io/packagist/l/tombenevides/metavel\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n---\n\nMetabase is an open source business intelligence platform where you can create charts/grids (known as questions) or a collection of questions (known as dashboards) as a custom visualization for your data. One of Metabase's features is embedding. Therefore, this package provides blade components that abstract the platform integration, allowing you to easily embed your question/dashboard in a Laravel application.\n\n![image](https://user-images.githubusercontent.com/18440704/226209981-defde2b1-5fb3-42da-8d6f-f9088f68e10f.png)\n\n\n\n## REQUIREMENTS\n\u003e **[PHP 8.1+](https://www.php.net/releases/)**\n\u003e\n\u003e **[Laravel 10](https://github.com/laravel/laravel)**\n\n\n## HOW TO INSTALL\n\nTo install the package, just use [composer](https://getcomposer.org):\n\n```bash\ncomposer require tombenevides/metavel\n```\n\n## HOW TO USE\n\n### Configuring Metabase credentials\n\nAfter installing, publish your config file using:\n\n```bash\nphp artisan vendor:publish --tag=metavel-config\n```\n\nThis will create a `metavel.php` file in your config folder. There, you'll see the environment variables to set the Metabase's base url and secret key.\n\n```env\nMETAVEL_BASE_URL #Metabase base url\nMETAVEL_SECRET_KEY #Metabase secret key\n```\n\nYou will also find in the config file a *expiration_time* option. Since the communication between Laravel and Metabase works with JWT, using this option you can set an exp date for you generated token. The value is in seconds using NumericDate format. \n\n### Call the component\n\nAfter setting the platform credentials, you just need to call the match component in your blade file. There's two components, one for questions and other for dahsboards:\n\n```blade\n\u003cbody\u003e\n  \u003cx-metavel-question :resource=89 /\u003e\n  \n  \u003cx-metavel-dashboard :resource=10 /\u003e\n\u003c/body\u003e\n```\n\nThe components have some properties that you can set to customize the embbeding. Most of them are optional, except for **resource**, which is the ID of the element on Metabase (question or dashboard). Besides that, you can also set:\n\n| Property  | Type    | default value | Description                                      |\n|-----------|---------|---------------|--------------------------------------------------|\n| params    | array   | [ ]           | if your question/dashboard have implicit filters |\n| bordered  | boolean | true          | to load (or not) borders in the element          |\n| titled    | boolean | true          | to load (or not) the element original title      |\n| darkTheme | boolean | false         | to load (or not) the element with dark theme     |\n| width     | int     | 1366          | set the width of the element                     |\n| height    | int     | 768           | set the height of the element                    |\n\n### Styling\n\nAs a blade component, you can add HTML attributes as classes for styling, for example. The Metabase element is loaded in an iframe but it's encapsulated by a div that receives the attributes, as shown below::\n\n```php\n\u003cbody\u003e\n  \u003cx-metavel-question :resource=89 class=\"w-full\" /\u003e\n\u003c/body\u003e\n```\n\nThis will generate:\n\n```html\n\u003cdiv class=\"w-full\"\u003e\n   \u003ciframe....\n\u003c/div\u003e\n```\n\n## LICENSE\n\n**Metavel** is a software under the [MIT License](LICENSE)\n\n## UPDATES\n\n👋 Follow the author [@devatreides](https://twitter.com/devatreides) on Twitter to know more about the last updates and other projects. Say Hi!\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdevatreides%2Fmetavel","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdevatreides%2Fmetavel","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdevatreides%2Fmetavel/lists"}