Fix PHP 5.0 and other early version compatibility by removing use of __toString
[htmlpurifier.git] / TODO
blob41973ab057cd3cfa0304f75e9c0c6081b3bfc815
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  - Document new ConfigSchema setup and format; dev-includes.txt is a base
23    but we need it in HTML
24  - Update French translation of README
25  - Document which scripts need to be called when a change is made
27 IMPORTANT FEATURES
28  - Get everything into configuration objects (filters, I'm looking at you)
29  - Factor generate-schema-cache.php into a class, so that the maintenance script
30    is as small as possible
31  - Factor out command line parser into its own class, and unit test it
32  - Optimize ConfigSchema by making our runtime class only contain entries for
33    things necessary for operation (NOT descriptions).
35 CONFIGDOC
36  - Properly integrate new ConfigSchema system into configdoc. DESCRIPTIONS
37    ARE CURRENTLY BROKEN AND NEED TO BE FIXED!!! (Configdoc
38    should directly read the configuration files, or at the very least should
39    not use static functions)
40  - Deprecate Serializer in favor of ReverseAdapter
41  - Have configdoc use version and deprecated information (hide deprecated
42    info, for example)
43  - Implement source code sniffing for configdoc, so we can easily figure out
44    which files use what configuration (we'll rely on the $config convention)
46 IF IT AIN'T BROKE...
47  - Perhaps replace types with integer identifiers in ConfigSchema? (would be
48    smaller, but not by much).
50 NICE FEATURES
51  - Factor demo.php into a set of Printer classes, and then create a stub
52    file for users here (inside the actual HTML Purifier library)
53  - Support exporting configuration, so users can easily tweak settings
54    in the demo, and then copy-paste into their own setup
57 FUTURE VERSIONS
58 ---------------
60 3.2 release [Error'ed]
61  # Error logging for filtering/cleanup procedures
62  - XSS-attempt detection
64 3.3 release [Do What I Mean, Not What I Say]
65  # Additional support for poorly written HTML
66     - Microsoft Word HTML cleaning (i.e. MsoNormal, but research essential!)
67     - Friendly strict handling of <address> (block -> <br>)
68  - Remove redundant tags, ex. <u><u>Underlined</u></u>. Implementation notes:
69     1. Analyzing which tags to remove duplicants
70     2. Ensure attributes are merged into the parent tag
71     3. Extend the tag exclusion system to specify whether or not the
72     contents should be dropped or not (currently, there's code that could do
73     something like this if it didn't drop the inner text too.)
74  - Remove <span> tags that don't do anything (no attributes)
75  - Remove empty inline tags<i></i>
76  - Append something to duplicate IDs so they're still usable (impl. note: the
77    dupe detector would also need to detect the suffix as well)
78  - Externalize inline CSS to promote clean HTML
80 3.4 release [It's All About Trust] (floating)
81  # Implement untrusted, dangerous elements/attributes
82  # Implement IDREF support (harder than it seems, since you cannot have
83    IDREFs to non-existent IDs)
84  # Frameset XHTML 1.0 and HTML 4.01 doctypes
86 4.0 release [Beyond HTML]
87  # Legit token based CSS parsing (will require revamping almost every
88    AttrDef class). Probably will use CSSTidy class
89  # More control over allowed CSS properties (maybe modularize it in the
90    same fashion!)
91  # HTML 5 support
92  - Standardize token armor for all areas of processing
93  - Convert RTL/LTR override characters to <bdo> tags, or vice versa on demand.
94    Also, enable disabling of directionality
95  - Table of Contents generation (XHTML Compiler might be reusable)
97 5.0 release [To XML and Beyond]
98  - Extended HTML capabilities based on namespacing and tag transforms (COMPLEX)
99     - Hooks for adding custom processors to custom namespaced tags and
100       attributes, offer default implementation
101     - Lots of documentation and samples
103 Ongoing
104  - More refactoring to take advantage of PHP5's facilities 
105  - Lots of profiling, make it faster!
106  - Plugins for major CMSes (COMPLEX)
107     - phpBB
108     - more! (look for ones that use WYSIWYGs)
109  - Complete basic smoketests
111 AutoFormat
112  - Smileys
113  - Syntax highlighting with <pre> and possibly <?php
114  - Look at http://drupal.org/project/Modules/category/63 for ideas
116 Unknown release (on a scratch-an-itch basis)
117  # CHMOD install script for PEAR installs
118  ? Have 'lang' attribute be checked against official lists, achieved by
119    encoding all characters that have string entity equivalents
120  - Abstract ChildDef_BlockQuote to work with all elements that only
121    allow blocks in them, required or optional
122  - Reorganize Unit Tests
123  - Advanced URI filtering schemes (see docs/proposal-new-directives.txt)
124  - Implement lenient <ruby> child validation
125  - Explain how to use HTML Purifier in non-PHP languages / create
126    a simple command line stub (or complicated?)
127  - Fixes for Firefox's inability to handle COL alignment props (Bug 915)
128  - Automatically add non-breaking spaces to empty table cells when
129    empty-cells:show is applied to have compatibility with Internet Explorer
130  - Distinguish between default settings and explicitly set settings, so
131    configurations can be merged
132  - Nested configuration namespaces
133  - Allow scoped="scoped" attribute in <style> tags; may be troublesome
134    because regular CSS has no way of uniquely identifying nodes, so we'd
135    have to generate IDs
136  - Time PHPT tests
138 Requested
140 Wontfix
141  - Non-lossy smart alternate character encoding transformations (unless
142    patch provided)
143  - Pretty-printing HTML: users can use Tidy on the output on entire page
144  - Native content compression, whitespace stripping (don't rely on Tidy, make
145    sure we don't remove from <pre> or related tags): use gzip if this is
146    really important