[x] Edit and finalize draft for publishing (remove draft label, add draft-finalized label)
[ ] Assign Issue to yourself and create Markdown file (remove draft-finalized label, add pending)
[ ] Project Lead: Review and Publish KB Article (remove pending label, add published label)
title: When using the GitHub Integration, will I lose data if I delete a KB Article in WordPress?
categories: questions
tags:
author: raamdev
github-issue: https://github.com/websharks/wp-kb-articles-kb/issues/4
Question: If I'm using the GitHub Integration to automatically import Markdown files from a GitHub Repo, what happens when I delete a KB Article in WordPress? Will I lose any data?
Answer: When using the GitHub Integration, any KB Articles that you delete in WordPress will be automatically recreated the next time the GitHub Processor runs. Any YAML data specified in the Markdown file will be used to recreate the KB Article in WordPress and the content of the Markdown file will be used to recreate the KB Article itself.
However, depending on your specific configuration, some data may be lost.
Data that may be lost when deleting a KB Article in WordPress while using the GitHub Integration
Article Popularity. The data regarding how many times visitors have clicked the Heart Button to indicate they liked the article, will be lost, as that data is stored in the WordPress database with the entry for the KB Article itself.
Article settings not specified in the YAML configuration. If you customized the settings for an article inside WordPress (such as changing Categories, Tags, enabling/disabling Comments or Pings, etc.), those changes will be lost the next time the GitHub Processor imports the article. (To preserve such changes, always update the YAML Configuration inside the Markdown file itself. The next time the GitHub Processor runs, it will detect those changes and update the settings for the KB Article in WordPress.)
Comments and Pings. If you enabled Comments and/or Pings on this article, any comments or pings that were left on the article will be deleted when the KB Article is deleted in WordPress. The next time the GitHub Processor runs and recreates the KB Article, those comments and/or pings will no longer exist.
KB Article Creation Checklist
draft
and eitherquestions
ortutorials
draft
label, adddraft-finalized
label)draft-finalized
label, addpending
)pending
label, addpublished
label)Question: If I'm using the GitHub Integration to automatically import Markdown files from a GitHub Repo, what happens when I delete a KB Article in WordPress? Will I lose any data?
Answer: When using the GitHub Integration, any KB Articles that you delete in WordPress will be automatically recreated the next time the GitHub Processor runs. Any YAML data specified in the Markdown file will be used to recreate the KB Article in WordPress and the content of the Markdown file will be used to recreate the KB Article itself.
However, depending on your specific configuration, some data may be lost.
Data that may be lost when deleting a KB Article in WordPress while using the GitHub Integration