{"id":20672083,"url":"https://github.com/workarea-commerce/workarea-blog","last_synced_at":"2025-04-19T18:50:37.060Z","repository":{"id":47972799,"uuid":"203648210","full_name":"workarea-commerce/workarea-blog","owner":"workarea-commerce","description":null,"archived":false,"fork":false,"pushed_at":"2023-01-04T21:59:22.000Z","size":974,"stargazers_count":1,"open_issues_count":8,"forks_count":2,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-03-29T11:51:41.842Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Ruby","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/workarea-commerce.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2019-08-21T19:07:57.000Z","updated_at":"2020-12-14T13:36:55.000Z","dependencies_parsed_at":"2023-02-02T21:16:49.471Z","dependency_job_id":null,"html_url":"https://github.com/workarea-commerce/workarea-blog","commit_stats":null,"previous_names":[],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/workarea-commerce%2Fworkarea-blog","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/workarea-commerce%2Fworkarea-blog/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/workarea-commerce%2Fworkarea-blog/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/workarea-commerce%2Fworkarea-blog/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/workarea-commerce","download_url":"https://codeload.github.com/workarea-commerce/workarea-blog/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":249153915,"owners_count":21221330,"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-11-16T20:31:51.403Z","updated_at":"2025-04-19T18:50:37.042Z","avatar_url":"https://github.com/workarea-commerce.png","language":"Ruby","funding_links":[],"categories":[],"sub_categories":[],"readme":"Workarea Blog\n================================================================================\n\nA Workarea Commerce plugin for creating and managing blogs and blog entries.\n\nOverview\n--------------------------------------------------------------------------------\n\n* Creation and management of one or more unique blogs per site\n* Utilizes existing content blocks in blog entry creation\n* Support for blog Entry Comments \u0026 Moderation\n* Support for importing from Wordpress\n\nGetting Started\n--------------------------------------------------------------------------------\n\nAdd the gem to your application's Gemfile:\n\n```ruby\n# ...\ngem 'workarea-blog'\n# ...\n```\n\nUpdate your application's bundle.\n\n```bash\ncd path/to/application\nbundle\n```\n\nFeatures\n--------------------------------------------------------------------------------\n\n### Blogs and Entries vs. Categories and Posts\n\nThe workarea blog plugin uses the model 'Blog' as the parent model for\n'Entries'.  A site may have many blogs, and a blog may have many entries. This\nis similar to the idea of 'Categories' and 'Posts' in other blogging\nplatforms.\n\n### Commenting and Comment Moderation\n\nReaders are permitted to comment on Blog Entries. Admin users with the proper\npermissions may moderate comments left by readers.\n\n### Importing Wordpress Content\n\nThe workarea-blog plugin includes a set of rake tasks to import content from\nWordpress blogs. These tasks require an XML export from wordpress, this can be\ngenerated from the Wordpress admin by following the instructions found here:\n\u003chttps://codex.wordpress.org/Tools_Export_Screen\u003e. Hosted wordpress.com blogs\nwill have a slightly different interface, but the process is much the same.\nYou should do a complete export of all data, including attachments, posts, and\npages.\n\nOnce you have the XML file downloaded you need to save it in your application.\nThe import will look for `/data/blog/wordpress.xml` by default, you can\nconfigure the import to use a different path if necessary.\n\nMore information below.\n\nWordpress Import\n--------------------------------------------------------------------------------\n\n### Gotchas with importing Wordpress content\n\nAll post and page content will be created as an HTML content block. This will\nmaintain any semantic HTML styles like `\u003cstrong\u003e` `\u003ci\u003e` and heading tags.\nHowever, we do not import styles from Wordpress, so any styles coming from\ncustom classes will not be included. You should set your customer's expectations\naround this.  If necessary you could replicate custom styles from wordpress in\nyour application, or re-write classes as necessary to match classes in the\nWorkarea application.\n\nDepending on which version of wordpress and which editor was used, some\nwordpress posts contain markup that will cause the HTML to be stripped. Before\nimporting you should look at the `\u003ccontent:encoded\u003e` fields in the wordpress.xml\nand ensure there are no comments that look like this `\u003c!-- wp:paragraph --\u003e`. If\nthese comments are present you will need to remove them manually.\n\n### Post types for import\n\nBefore running the import you should examine the wordpress.xml file, checking\npost types. If your Wordpress blog uses custom post types you will need to\ncustomize the import to handle those.\n\nThe wordpress import scripts will handle the following post types:\n\n* Attachment - Imported as assets\n* Post - Imported as Blog Entries\n* Page - Imported as Content Pages\n\n### Import configuration\n\nBefore running the import task you should use an initializer to configure the\nblog name and author name for all posts coming from Wordpress. If a blog does\nnot exist with a matching name it will be created. All posts will be attributed\nto the same author name, per the configuration.\n\nDefault configuration:\n\n```ruby\nWorkarea.configure do |config|\n  config.wordpress_import = {\n    'blog_name': 'Wordpress Import',\n    'author_name': 'Wordpress User'\n  }\nend\n```\n\n### Running the import\n\nTo run the complete import run `bundle exec rake\nworkarea:blog:import_wordpress`.  This will import attachments, posts, and pages\nfrom the XML file provided. You can also run each of these tasks individually if\nnecessary. If you opt to do this you *must* run the\n`workarea:blog:import_wordpress_attachments` task first as these assets need to\nexist before any posts or pages can reference them.\n\n#### Using a different path for import\n\nAll import tasks allow a custom path to be used if necessary. The default path\nfor your wordpress xml export is `/data/blog/wordpress.xml`. To use a different\n  path you can pass an argument to the rake task, note that the new path should\n  be from your application root directory. Example:\n\n```bash\nbundle exec rake workarea:blog:import_wordpress['path/to/your/new_wordpress.xml']\n```\n\nWebLinc Platform Documentation\n--------------------------------------------------------------------------------\n\nSee [https://developer.workarea.com](https://developer.workarea.com) for Workarea Commerce documentation.\n\nLicense\n--------------------------------------------------------------------------------\n\nWorkarea Blog is released under the [Business Software License](LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fworkarea-commerce%2Fworkarea-blog","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fworkarea-commerce%2Fworkarea-blog","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fworkarea-commerce%2Fworkarea-blog/lists"}