{"id":13572057,"url":"https://github.com/Chicago/metalicious","last_synced_at":"2025-04-04T09:31:34.674Z","repository":{"id":8460078,"uuid":"10056720","full_name":"Chicago/metalicious","owner":"Chicago","description":"An open source data dictionary which can be deployed to track the metadata of one or more databases.","archived":false,"fork":false,"pushed_at":"2016-03-20T19:20:01.000Z","size":748,"stargazers_count":65,"open_issues_count":17,"forks_count":22,"subscribers_count":21,"default_branch":"master","last_synced_at":"2024-11-05T05:33:47.758Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Chicago.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2013-05-14T14:16:47.000Z","updated_at":"2024-06-12T10:47:01.000Z","dependencies_parsed_at":"2022-09-14T08:13:45.292Z","dependency_job_id":null,"html_url":"https://github.com/Chicago/metalicious","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Chicago%2Fmetalicious","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Chicago%2Fmetalicious/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Chicago%2Fmetalicious/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Chicago%2Fmetalicious/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Chicago","download_url":"https://codeload.github.com/Chicago/metalicious/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247153257,"owners_count":20892622,"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-01T14:01:12.300Z","updated_at":"2025-04-04T09:31:29.661Z","avatar_url":"https://github.com/Chicago.png","language":"PHP","funding_links":[],"categories":["PHP"],"sub_categories":[],"readme":"README\n======\nMetalicious is an open-source, web-based data dictionary that is designed to capture and display metadata from databases, tables, and fields for platforms with one or more databases. Users may customize and deploy Metalicious as an internal or public data dictionary website.\n\nThis project is a generic release of the City of Chicago's [data dictionary](http://datadictionary.cityofchicago.org).\n\nInstallation\n============\nCopy the repository or download a compressed folder and unpack the directory to the folder you wish to host Metalicious.\n\nImporting Database\n------------------\nUsing the command line, run the following script:\n```bash\nmysql -u db-username -p -h yourlocaldatabase \u003c database/Metalicious_DB.sql\n```\nMetalicious will create a new database called \"datadictionary\". Ensure no database with the same name exists as Metalicious will overwrite pre-existing data.\n\n\nCreating Users\n--------------\nThere is not a way to enter new users through the website in the current version. Adding new users will require access to the MySQL server and database. Use the following script to add new users:\n```sql\nINSERT INTO Users\n\t(User_Name, Password, First_Name, Last_Name)\nVALUES\n\t('_username-to-be-added_', '_password_', '_user-first-name_', '_user-last-name_');\n```\nWhere the \\_underscored\\_ arguments will be inserted into the user account.\n\nCreating Business Functions\n---------------------------\n\"Business Functions\" is used to create categories to help users navigate to data dictionary entries. Currently, Metalicious does not support adding business functions through the website. Instead, new functions can be added through the following commands:\n```sql\nINSERT INTO Business_Functions\n\t(Business_Function_Name, Business_Function_Description)\nVALUES\n\t('_business-function-to-be-added_', '_business-function-description_');\n```\nThe \\_underscored\\_ entries may be modified to fit your needs.\n\nDeploying Website\n-----------------\nMove the contents of /web to the directory you wish to deploy Metalicious.\n\nAfter moving the contents, configure /include/dbconnopen.php to the appropriate MySQL database and login information:\n```php\n$cnnCDD = mysqli_connect(\"_yourlocaldatabase_\", \"_db-username_\", \"_db-password_\")\n```\n\nThe deployment of Metalicious assumes it will be installed in the root directory of the server (e.g., DOCUMENT_ROOT). To change this behavior, modify the file location.php \n\nEditing Contact Form\n--------------------\nMetalicious includes a contact form for users to contact a central location. You can edit the contact information in _ajax/contact_send.php_ \n```php\n$to = \"\\\"_email-name_\\\" \u003cemail-address@example.com\u003e\";\n$subject = \"Metalicious Data Dictionary: Online Comment / Question / Suggestion\";\n```\n\nAdding Data\n===========\n\nAdding a new system or revising an existing system\n-------------------\n1.\tLog into website\n\tUsername: beginning of e+mail address (i.e. jsmith – do not include @gmail.com)\n\tPassword: same as username\n2.\tVisit example.com/database_info.php, where example.com is the directory hosting Metalicious. Click \"Create New DB\"\n\tNote: If a database has been created, you may open an existing database to create a new database\n3.\tEnter all relevant information on the system \n4.\tSelect “Create New Database” once all information has been entered\n\tNote: This will create the database, but it will not yet appear on the website\n5.\tActivate the database \n\tClick on your name at the top of the screen and select “Admin” from the drop down\n\tClick on the database and then select “Activate Revision”\n\tThe system will now appear on the website.  Note: The database will need to be activated in order for it to be complete and appear in the website as well as for you to add the business function.\n6.\tAdding the Business Function\n\tUse the “Search” feature to open up the new database\n\tAt the end of the database detail table, select the business function where this database belongs\n\tFollow step 7 to update the revision\n7.\tMaking Revisions to a database\n\tClick “Change Info” at the end of the database detail \n+\tClick “Save Revisions”\n\tClick “Database Revisions” and click “Load this revision” next to the appropriate dated revision.\n\n\nImporting a table\n-----------------\n1.\tSteps to take to get file ready for importing\n+\tSee examples of the [table file](data-examples/CongregateDiningMealCount_tables.csv) derived from the [City of Chicago Congregate Dining Meal Application](http://datadictionary.cityofchicago.org/database_info.php?database_id=58)\n+\tCopy all relevant fields (system, table, column/field, type, length, value range, description, examples, comments) with no header row and paste into a separate excel file and save as CSV (comma delimited) file.\n+\tThe System name in the file must match exactly how the system is named in the website.  For example, if the system is titled “Attendance System” in the website, the spreadsheet must have “Attendance System” listed under the system column.\n2.\tLog into website\n3.\tSelect “import” from the drop down list under your name \n4.\tSelect the “browse” button under the second option - Choose your Tables.csv file and then click on the submit button\n5.\tAdd the appropriate variable CSV file\n6.\tSelect “submit”\n\n\nImporting a variable\n---------------------\n1.\tSteps to take to get file ready for importing\n+\tSee examples of the [variable file](data-examples/CongregateDiningMealCount_variables.csv) derived from the [City of Chicago Congregate Dining Meal Application](http://datadictionary.cityofchicago.org/database_info.php?database_id=58)\n+\tCopy all relevant fields (system, table, column/field, type, length, value range, description, examples, comments) with no header row and paste into a separate excel file and save as CSV (comma delimited) file.\n+\tThe System name in the file must match exactly how the system is named in the website.  For example, if the system is titled “Attendance System” in the website, the spreadsheet must have “Attendance System” listed under the system column.\n2.\tLog into website\n3.\tSelect “import” from the drop down list under your name \n4.\tSelect the “browse” button under the second option - Choose your Variables.csv file and then click on the submit button\n5.\tAdd the appropriate variable CSV file\n6.\tSelect “submit”\n\n\n\nRequirements\n============\n\nMetalicious has not gone through broad deployment testing. Below are the specifications which this project was built. We appreciate feedback on other platforms which Metalicious does and does not operate.\n\nSystem Requirements\n-------------------\nSevers hosting this project requires. This project was developed with the following specifications:\n+ MySQL Community Server 5.5.25a\n+ PHP 5.4.5\n\nLicense \u0026 Support\n-----------------\n\nMetalicious is released under an MIT-style license. Portions of the design of the website uses [Font Awesome](http://fortawesome.github.com/Font-Awesome/) in the design, which is licensed under [CC BY 3.0](http://creativecommons.org/licenses/by/3.0/). Other licensed components of this project are compatible with an MIT license. The complete license is contained in the LICENSE file at the root of this distribution. By using this software in any fashion, you are agreeing to be bound by the terms of this license. You must not remove this notice, or any other, from this software.\n\nThe City of Chicago and its partners do not assume liability or support of Metalicious.\n\nAcknowledgements\n----------------\n\nMetalicious was developed with support from the [MacArthur Foundation](http://www.macfound.org/) and [Chapin Hall at the University of Chicago](http://www.chapinhall.org/).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FChicago%2Fmetalicious","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FChicago%2Fmetalicious","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FChicago%2Fmetalicious/lists"}