def add_revision(self,
newrevision,
request,
article_revision=None,
save=True):
"""
Given a revision to make to the metadata, save it,
and create a new article revision so they are in parallel unless one is provided.
If an article revision is provided, then link the metadata revision to it;
otherwise, initially save metadata_revision.article_revision as null
(the signal triggered by the new article revision being saved will lead to this
method being called again with the article_revision).
"""
if article_revision is None:
# first save the submitted metadata. article_revision will be null
super(Metadata, self).add_revision(newrevision, save=save)
# create article revision
article_revision = ArticleRevision()
article_revision.inherit_predecessor(self.article)
article_revision.set_from_request(request)
article_revision.automatic_log = newrevision.automatic_log
self.article.add_revision(article_revision, save=save)
# will trigger the on_article_revision_pre_save signal handler,
# which calls this method again, supplying an article_revision
else:
# update the metadata revision so it is attached to an article_revision
newrevision.article = self.article # defined in ArticlePlugin, which SimplePlugin and RevisionPlugin both inherit from
newrevision.article_revision = article_revision
super(Metadata, self).add_revision(newrevision, save=save)
def update(article, content, user=None, message="", title=None):
"""
Update an article, creating a new revision.
Args:
article (Article): the article object.
content (str): the new content of the article.
user (Account, optional): the user responsible for the update.
message (str, optional): the message of the update.
title (str, optional): the new article's title.
Note:
If `user` isn't set, get the account #1 (the superuser).
If `title` is unset, will use the current article's title.
"""
user = user or AccountDB.objects.get(id=1)
current = article.current_revision
title = title if title is not None else current.title
revision = ArticleRevision()
revision.inherit_predecessor(article)
revision.title = title
revision.content = content
revision.user_message = message
revision.deleted = False
revision.ip_address = "127.0.0.1"
article.add_revision(revision)
return revision
def form_valid(self, form):
"""Create a new article revision for the bot wiki page when the form is valid"""
# If the article content is different, add a new revision
if form.instance.wiki_article.current_revision.content != form.cleaned_data['wiki_article_content']:
revision = ArticleRevision()
revision.inherit_predecessor(form.instance.wiki_article)
revision.title = form.instance.name
revision.content = form.cleaned_data['wiki_article_content']
# revision.user_message = form.cleaned_data['summary']
revision.deleted = False
revision.set_from_request(self.request)
form.instance.wiki_article.add_revision(revision)
return super(BotUpdate, self).form_valid(form)
def save(self, *args, **kwargs):
self.instance = self.article.category
data = self.cleaned_data
oldparent = self.instance.parent
newparent = data['parent']
if newparent != oldparent: # parent has changed
# make a new revision of the article to record the change
revision = ArticleRevision()
revision.inherit_predecessor(self.article)
revision.set_from_request(self.request)
revision.parent = newparent
revision.categories = self.article.categories
if oldparent:
oldparent = oldparent.name
revision.automatic_log = f'Parent Category: {oldparent} → {newparent.name if newparent else "None"} (not revertible)'
self.article.add_revision(revision)
# reverting to a previous revision from the Changes page currently does not affect the category parent
self.instance.parent = newparent
self.instance.save()
super(EditCategoryForm, self).save(*args, **kwargs)