{"id":20101316,"url":"https://github.com/molkobain/itop-markdown-viewer","last_synced_at":"2025-05-06T06:33:21.522Z","repository":{"id":81535768,"uuid":"179749433","full_name":"Molkobain/itop-markdown-viewer","owner":"Molkobain","description":"Extension for iTop: Easily edit fields in Markdown without any modification to your datamodel!","archived":false,"fork":false,"pushed_at":"2024-09-16T21:09:10.000Z","size":890,"stargazers_count":5,"open_issues_count":1,"forks_count":2,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-04-09T09:51:47.829Z","etag":null,"topics":["hacktoberfest","itop","itop-extension","itop-module","markdown","markdown-editor","showdownjs"],"latest_commit_sha":null,"homepage":"https://www.molkobain.com","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Molkobain.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":".github/FUNDING.yml","license":null,"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},"funding":{"github":["Molkobain"],"patreon":null,"open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"custom":null}},"created_at":"2019-04-05T20:23:26.000Z","updated_at":"2024-12-31T00:43:26.000Z","dependencies_parsed_at":null,"dependency_job_id":"ab443187-69e9-4ff6-9e01-19ddd821ae47","html_url":"https://github.com/Molkobain/itop-markdown-viewer","commit_stats":null,"previous_names":[],"tags_count":8,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Molkobain%2Fitop-markdown-viewer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Molkobain%2Fitop-markdown-viewer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Molkobain%2Fitop-markdown-viewer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Molkobain%2Fitop-markdown-viewer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Molkobain","download_url":"https://codeload.github.com/Molkobain/itop-markdown-viewer/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252633883,"owners_count":21779940,"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":["hacktoberfest","itop","itop-extension","itop-module","markdown","markdown-editor","showdownjs"],"created_at":"2024-11-13T17:24:36.994Z","updated_at":"2025-05-06T06:33:21.076Z","avatar_url":"https://github.com/Molkobain.png","language":"PHP","funding_links":["https://github.com/sponsors/Molkobain"],"categories":[],"sub_categories":[],"readme":"👋 [Available on Molkobain I/O](https://www.molkobain.com/product/markdown-viewer/)\n\n# iTop extension: molkobain-markdown-viewer\n* [Description](#description)\n* [Online demo](#online-demo)\n* [Compatibility](#compatibility)\n* [Downloads](#downloads)\n* [Installation](#installation)\n* [Configuration](#configuration)\n* [Change log](CHANGELOG.md)\n\n## Description\nEasily edit fields in Markdown without any modification to your datamodel! Perfect for FAQs and many others objects 👌\n\nAdvanced features support such as headings, emphasis, lists, images, hyperlinks, highlighting, code formatting...\n\n![Description decoration](docs/mmv-console-edition-01.png)\n\nInstant preview of Markdown rendering while editing\n![Preview while editing](docs/mmv-console-preview-01.png)\n\nFully compatible with the enhanced portal in both visualization...\n![Portal visualization](docs/mmv-portal-view-01.png)\n\n... and edition with instant preview\n![Portal editing](docs/mmv-portal-edition-01.png)\n![Portal preview](docs/mmv-portal-preview-01.png)\n\n## Online demo\nYou can try this extension on the online demo. There are already some FAQs with a markdown description as an example. Just click on the links below to access it:\n* [Administration console](http://mbc.itop.molkobain.com/pages/UI.php?operation=details\u0026class=FAQ\u0026id=1\u0026c[menu]=FAQ\u0026auth_user=admin\u0026auth_pwd=admin) (admin / admin)\n* [Enhanced portal](http://mbc.itop.molkobain.com/pages/exec.php/object/view/FAQ/1?exec_module=itop-portal-base\u0026exec_page=index.php\u0026portal_id=itop-portal\u0026auth_user=portal\u0026auth_pwd=portal) (portal / portal)\n\n*Note: Mind to logout before switching between console \u0026 portal.*\n\n## Compatibility\nCompatible with iTop 2.7+\n\n## Dependencies\n* Module `molkobain-handy-framework/1.3.0`\n* Module `molkobain-newsroom-provider/1.0.1`\n\n*Note: All dependencies are included in the `dist/` folder, so all you need to do is follow the installation section below.*\n\n## Downloads\nStable releases can be found on the [releases page](https://github.com/Molkobain/itop-markdown-viewer/releases) or on [Molkobain I/O](https://www.molkobain.com/product/markdown-viewer/).\n\nDownloading it directly from the Clone or download will get you the version under development which might be unstable.\n\n## Installation\nInstallation procedure is the same as for any iTop extension, just follow the instruction on the iTop official documentation [here](https://www.itophub.io/wiki/page?id=extensions%3Ainstallation).\n\n## Configuration\nOut of the box this extension doesn't change any attributes, you have to configure which attributes you want to be rendered as Markdown. To do so, take a look at the ``markdown_attributes`` parameter in the next section.\n\n### Parameters\nSome configuration parameters are available from the Configuration editor of the console:\n* ``enabled`` Enable / disable the extension without having to uninstall it. Value can be ``true`` or ``false``.\n* ``markdown_attributes`` Class attributes to enable as Markdown. Value must be an array of classes, each containing an array of the attributes you want to render as Markdown. Default value is none, you have to set which ones you want!\n* ``markdown_options`` Allow to set the options of the Markdown converter ([Showdown.js](https://github.com/showdownjs/showdown)), check the dedicated [wiki page](https://github.com/showdownjs/showdown/wiki/Showdown-Options) to see them all.\n\n*Example:*\n```\n'molkobain-markdown-viewer' =\u003e array (\n  'enabled' =\u003e true,\n  'markdown_attributes' =\u003e array(\n    'Service' =\u003e array('description'),\n    'ServiceSubcategory' =\u003e array('description'),\n    'FAQ' =\u003e array('summary', 'description'),\n  ),\n  'markdown_options' =\u003e array(\n    'tables' =\u003e true,\n  ),\n),\n```\n\n## Contributors\nI would like to give a special thank you to the people who contributed to this:\n - Bostoen, Jeffrey a.k.a @jbostoen\n \n## Licensing\nThis extension is under [AGPLv3](https://en.wikipedia.org/wiki/GNU_Affero_General_Public_License).\n\n## Third party libs\nThis extension is based on the awesome Showdown library. For more information visit its [website](https://github.com/showdownjs/showdown).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmolkobain%2Fitop-markdown-viewer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmolkobain%2Fitop-markdown-viewer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmolkobain%2Fitop-markdown-viewer/lists"}