[3.1.0] Document Config Schema, also, fix bug with null defaults
[htmlpurifier.git] / TODO
blob8445f69e7ca1c2340fcc6d8762bd0fc7439b55ca
2 TODO List
4 = KEY ====================
5     # Flagship
6     - Regular
7     ? Maybe I'll Do It
8 ==========================
10 If no interest is expressed for a feature that may required a considerable
11 amount of effort to implement, it may get endlessly delayed. Do not be
12 afraid to cast your vote for the next feature to be implemented!
15 UPCOMING RELEASE
16 ----------------
18 IMPORTANT
19  - Release candidate, because of the major changes
21 DOCUMENTATION
22  - Update French translation of README
24 IMPORTANT FEATURES
25  - Get everything into configuration objects (filters, I'm looking at you)
26  - Factor out command line parser into its own class, and unit test it
28 CONFIGDOC
29  - Properly integrate new ConfigSchema system into configdoc. DESCRIPTIONS
30    ARE CURRENTLY BROKEN AND NEED TO BE FIXED!!! (Configdoc
31    should directly read the configuration files, or at the very least should
32    not use static functions)
33  - Have configdoc use version and deprecated information (hide deprecated
34    info, for example)
35  - Implement source code sniffing for configdoc, so we can easily figure out
36    which files use what configuration (we'll rely on the $config convention)
38 NICE FEATURES
39  - Factor demo.php into a set of Printer classes, and then create a stub
40    file for users here (inside the actual HTML Purifier library)
41  - Support exporting configuration, so users can easily tweak settings
42    in the demo, and then copy-paste into their own setup
44 BUGS
45  - Style attribute height/width limiting for images
46  - Easy way to blacklist elements and attributes
47  - Investigate iconv error emitting
48  - Investigate UTF-8 optimization <http://htmlpurifier.org/phorum/read.php?3,1496>
49  - Figure out what to do about target="" and name="", since they show up so often
50  - Update htmLawed comparison
52 FUTURE VERSIONS
53 ---------------
55 3.2 release [Error'ed]
56  # Error logging for filtering/cleanup procedures
57  - XSS-attempt detection
59 3.3 release [Do What I Mean, Not What I Say]
60  # Additional support for poorly written HTML
61     - Microsoft Word HTML cleaning (i.e. MsoNormal, but research essential!)
62     - Friendly strict handling of <address> (block -> <br>)
63  - Remove redundant tags, ex. <u><u>Underlined</u></u>. Implementation notes:
64     1. Analyzing which tags to remove duplicants
65     2. Ensure attributes are merged into the parent tag
66     3. Extend the tag exclusion system to specify whether or not the
67     contents should be dropped or not (currently, there's code that could do
68     something like this if it didn't drop the inner text too.)
69  - Remove <span> tags that don't do anything (no attributes)
70  - Remove empty inline tags<i></i>
71  - Append something to duplicate IDs so they're still usable (impl. note: the
72    dupe detector would also need to detect the suffix as well)
73  - Externalize inline CSS to promote clean HTML
75 3.4 release [It's All About Trust] (floating)
76  # Implement untrusted, dangerous elements/attributes
77     - Objects and Forms are especially wanted
78  # Implement IDREF support (harder than it seems, since you cannot have
79    IDREFs to non-existent IDs)
80  # Frameset XHTML 1.0 and HTML 4.01 doctypes
82 4.0 release [Beyond HTML]
83  # Legit token based CSS parsing (will require revamping almost every
84    AttrDef class). Probably will use CSSTidy class
85  # More control over allowed CSS properties (maybe modularize it in the
86    same fashion!)
87  # HTML 5 support
88  - Standardize token armor for all areas of processing
89  - Convert RTL/LTR override characters to <bdo> tags, or vice versa on demand.
90    Also, enable disabling of directionality
91  - Table of Contents generation (XHTML Compiler might be reusable)
93 5.0 release [To XML and Beyond]
94  - Extended HTML capabilities based on namespacing and tag transforms (COMPLEX)
95     - Hooks for adding custom processors to custom namespaced tags and
96       attributes, offer default implementation
97     - Lots of documentation and samples
99 Ongoing
100  - More refactoring to take advantage of PHP5's facilities 
101  - Lots of profiling, make it faster!
102  - Plugins for major CMSes (COMPLEX)
103     - phpBB
104     - more! (look for ones that use WYSIWYGs)
105  - Complete basic smoketests
107 AutoFormat
108  - Smileys
109  - Syntax highlighting with <pre> and possibly <?php
110  - Look at http://drupal.org/project/Modules/category/63 for ideas
112 Unknown release (on a scratch-an-itch basis)
113  # CHMOD install script for PEAR installs
114  ? Have 'lang' attribute be checked against official lists, achieved by
115    encoding all characters that have string entity equivalents
116  - Abstract ChildDef_BlockQuote to work with all elements that only
117    allow blocks in them, required or optional
118  - Reorganize Unit Tests
119  - Advanced URI filtering schemes (see docs/proposal-new-directives.txt)
120  - Implement lenient <ruby> child validation
121  - Explain how to use HTML Purifier in non-PHP languages / create
122    a simple command line stub (or complicated?)
123  - Fixes for Firefox's inability to handle COL alignment props (Bug 915)
124  - Automatically add non-breaking spaces to empty table cells when
125    empty-cells:show is applied to have compatibility with Internet Explorer
126  - Distinguish between default settings and explicitly set settings, so
127    configurations can be merged
128  - Nested configuration namespaces
129  - Allow scoped="scoped" attribute in <style> tags; may be troublesome
130    because regular CSS has no way of uniquely identifying nodes, so we'd
131    have to generate IDs
132  - Time PHPT tests
134 Requested
136 Wontfix
137  - Non-lossy smart alternate character encoding transformations (unless
138    patch provided)
139  - Pretty-printing HTML: users can use Tidy on the output on entire page
140  - Native content compression, whitespace stripping (don't rely on Tidy, make
141    sure we don't remove from <pre> or related tags): use gzip if this is
142    really important