You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@roller.apache.org by sn...@apache.org on 2023/07/01 22:21:32 UTC

[roller] branch inputs-and-docs created (now b6df63611)

This is an automated email from the ASF dual-hosted git repository.

snoopdave pushed a change to branch inputs-and-docs
in repository https://gitbox.apache.org/repos/asf/roller.git


      at b6df63611 Remove HTML from a couple of fields that should not allow HTML and clarify docs.

This branch includes the following new commits:

     new b6df63611 Remove HTML from a couple of fields that should not allow HTML and clarify docs.

The 1 revisions listed above as "new" are entirely new to this
repository and will be described in separate emails.  The revisions
listed as "add" were already present in the repository and have only
been added to this reference.



[roller] 01/01: Remove HTML from a couple of fields that should not allow HTML and clarify docs.

Posted by sn...@apache.org.
This is an automated email from the ASF dual-hosted git repository.

snoopdave pushed a commit to branch inputs-and-docs
in repository https://gitbox.apache.org/repos/asf/roller.git

commit b6df636117156a79c834e3fc9266338cc521d990
Author: David M. Johnson <sn...@apache.org>
AuthorDate: Sat Jul 1 18:21:27 2023 -0400

    Remove HTML from a couple of fields that should not allow HTML and clarify docs.
---
 app/src/main/java/org/apache/roller/weblogger/pojos/Weblog.java  | 9 +++++----
 .../java/org/apache/roller/weblogger/pojos/WeblogCategory.java   | 5 +++--
 .../java/org/apache/roller/weblogger/util/HTMLSanitizer.java     | 2 +-
 docs/roller-install-guide.adoc                                   | 3 +++
 docs/roller-user-guide.adoc                                      | 3 ++-
 5 files changed, 14 insertions(+), 8 deletions(-)

diff --git a/app/src/main/java/org/apache/roller/weblogger/pojos/Weblog.java b/app/src/main/java/org/apache/roller/weblogger/pojos/Weblog.java
index 7e196aa8c..46904f1b7 100644
--- a/app/src/main/java/org/apache/roller/weblogger/pojos/Weblog.java
+++ b/app/src/main/java/org/apache/roller/weblogger/pojos/Weblog.java
@@ -38,6 +38,7 @@ import org.apache.roller.weblogger.pojos.WeblogEntry.PubStatus;
 import org.apache.roller.util.UUIDGenerator;
 import org.apache.roller.weblogger.business.UserManager;
 import org.apache.roller.weblogger.util.I18nUtils;
+import org.apache.roller.weblogger.util.Utilities;
 
 
 /**
@@ -195,7 +196,7 @@ public class Weblog implements Serializable {
     }
     
     public void setName(String name) {
-        this.name = name;
+        this.name = Utilities.removeHTML(name);
     }
     
     /**
@@ -207,7 +208,7 @@ public class Weblog implements Serializable {
     }
     
     public void setTagline(String tagline) {
-        this.tagline = tagline;
+        this.tagline = Utilities.removeHTML(tagline);
     }
     
     /**
@@ -567,7 +568,7 @@ public class Weblog implements Serializable {
     /**
      * A description for the weblog (its purpose, authors, etc.)
      *
-     * This field is meant to hold a paragraph or two describing the weblog, in contrast
+     * This field is meant to hold a paragraph describing the weblog, in contrast
      * to the short sentence or two 'description' attribute meant for blog taglines
      * and HTML header META description tags.
      *
@@ -577,7 +578,7 @@ public class Weblog implements Serializable {
     }
 
     public void setAbout(String about) {
-        this.about = about;
+        this.about = Utilities.removeHTML(about);
     }
     
     
diff --git a/app/src/main/java/org/apache/roller/weblogger/pojos/WeblogCategory.java b/app/src/main/java/org/apache/roller/weblogger/pojos/WeblogCategory.java
index bc2d6b60f..1179c78c3 100644
--- a/app/src/main/java/org/apache/roller/weblogger/pojos/WeblogCategory.java
+++ b/app/src/main/java/org/apache/roller/weblogger/pojos/WeblogCategory.java
@@ -27,6 +27,7 @@ import org.apache.roller.weblogger.business.WebloggerFactory;
 import org.apache.roller.weblogger.business.WeblogEntryManager;
 import org.apache.roller.weblogger.pojos.WeblogEntry.PubStatus;
 import org.apache.roller.util.UUIDGenerator;
+import org.apache.roller.weblogger.util.Utilities;
 
 
 /**
@@ -133,7 +134,7 @@ public class WeblogCategory implements Serializable, Comparable<WeblogCategory>
     }
     
     public void setName(String name) {
-        this.name = name;
+        this.name = Utilities.removeHTML(name);
     }
     
     
@@ -145,7 +146,7 @@ public class WeblogCategory implements Serializable, Comparable<WeblogCategory>
     }
     
     public void setDescription(String description) {
-        this.description = description;
+        this.description = Utilities.removeHTML(description);
     }
 
     /**
diff --git a/app/src/main/java/org/apache/roller/weblogger/util/HTMLSanitizer.java b/app/src/main/java/org/apache/roller/weblogger/util/HTMLSanitizer.java
index 3f8230562..280e07917 100644
--- a/app/src/main/java/org/apache/roller/weblogger/util/HTMLSanitizer.java
+++ b/app/src/main/java/org/apache/roller/weblogger/util/HTMLSanitizer.java
@@ -100,7 +100,7 @@ public class HTMLSanitizer {
     }
 
     /**
-     * Used to get the text,  tags removed or encoded
+     * Used to get the text, tags removed or encoded
      *
      * @param html
      * @return sanitized text
diff --git a/docs/roller-install-guide.adoc b/docs/roller-install-guide.adoc
index b59dde170..8e6985319 100644
--- a/docs/roller-install-guide.adoc
+++ b/docs/roller-install-guide.adoc
@@ -55,6 +55,9 @@ will use your Roller site to author HTML, then you should configure
 Roller to sanitize all HTML published by the system. Do this by setting
 the _weblogAdminsUntrusted=true_ property in your
 _roller-custom.properties_ file.
+* *Do not allow File Uploads*. By default Roller allows users to upload
+files for display on their blogs. If don't trust your users, this is unsafe
+and you should disable File Uploads via the Server Administration page.
 * *Do not allow HTML in comments*. Roller can allow users to write
 comments in a safe-subset of HTML, but HTML use in comments is not
 allowed at all because of security concerns with even a so called
diff --git a/docs/roller-user-guide.adoc b/docs/roller-user-guide.adoc
index 6cd4bb5f0..83ffd2e46 100644
--- a/docs/roller-user-guide.adoc
+++ b/docs/roller-user-guide.adoc
@@ -890,7 +890,8 @@ Safari)
 is no longer active and should not appear in hot-blog and other weblog
 listing on the site. You might want to do this if you take a very long
 vacation or if you have decided to stop updating your weblog for some
-other reason.
+other reason. Your weblog will still be publicly available, but not
+shown in the main community page of your site (if there is one).
 * *Number of entries to display on weblog*: Enter the maximum number of
 entries to be displayed on your weblog.