Add documents on how to restructure configuration directives.
[htmlpurifier.git] / TODO
blob71fbc1f389d4b75a06c69c5c668d49ec86ce45e8
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 require 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!
14 - Investigate how early internal structures can be accessed; this would
15   prevent structures from being parsed and serialized multiple times.
16 - Built-in support for target="_blank" on all external links
17 - Incorporate data: support as implemented here:
18   http://htmlpurifier.org/phorum/read.php?3,3491,3548
19 - Fix ImgRequired to handle data correctly
20 - Provide callback/lookup table of allowed class attributes
21 - Think about allowing explicit order of operations hooks for transforms
22 - Allow more relaxed "class" definition than NMTOKENS for appropriate
23   doctypes
25 FUTURE VERSIONS
26 ---------------
28 4.1 release [It's All About Trust] (floating)
29  # Implement untrusted, dangerous elements/attributes
30  # Implement IDREF support (harder than it seems, since you cannot have
31    IDREFs to non-existent IDs)
32  # Frameset XHTML 1.0 and HTML 4.01 doctypes
33  - Implement <area>
34  - Figure out how to simultaneously set %CSS.Trusted and %HTML.Trusted (?)
36 4.2 release [Error'ed]
37  # Error logging for filtering/cleanup procedures
38  - XSS-attempt detection--certain errors are flagged XSS-like
40 4.3 release [Do What I Mean, Not What I Say]
41  # Additional support for poorly written HTML
42     - Microsoft Word HTML cleaning (i.e. MsoNormal, but research essential!)
43     - Friendly strict handling of <address> (block -> <br>)
44  ? Remove redundant tags, ex. <u><u>Underlined</u></u>. Implementation notes:
45     1. Analyzing which tags to remove duplicants
46     2. Ensure attributes are merged into the parent tag
47     3. Extend the tag exclusion system to specify whether or not the
48     contents should be dropped or not (currently, there's code that could do
49     something like this if it didn't drop the inner text too.)
50  - Remove <span> tags that don't do anything (no attributes)
51  - Append something to duplicate IDs so they're still usable (impl. note: the
52    dupe detector would also need to detect the suffix as well)
53  - Externalize inline CSS to promote clean HTML, proposed by Sander Tekelenburg
55 5.0 release [Beyond HTML]
56  # Legit token based CSS parsing (will require revamping almost every
57    AttrDef class). Probably will use CSSTidy class?
58  # More control over allowed CSS properties using a modularization
59  # HTML 5 support
60  # IRI support (this includes IDN)
61  - Standardize token armor for all areas of processing
62  - Convert RTL/LTR override characters to <bdo> tags, or vice versa on demand.
63    Also, enable disabling of directionality
65 6.0 release [To XML and Beyond]
66  - Extended HTML capabilities based on namespacing and tag transforms (COMPLEX)
67     - Hooks for adding custom processors to custom namespaced tags and
68       attributes, offer default implementation
69     - Lots of documentation and samples
71 Ongoing
72  - More refactoring to take advantage of PHP5's facilities
73  - Refactor unit tests into lots of test methods
74  - Plugins for major CMSes (COMPLEX)
75     - phpBB
76     - Drupal needs loving!
77     - Phorum need loving!
78     - more! (look for ones that use WYSIWYGs)
79     - Also, maybe a FAQ for extension writers with HTML Purifier
81 AutoFormat
82  - Smileys
83  - Syntax highlighting (with GeSHi) with <pre> and possibly <?php
84  - Look at http://drupal.org/project/Modules/category/63 for ideas
86 Optimizations
87  - Reduce size of internal data-structures (esp. HTMLDefinition)
88  - Research memory usage of objects versus arrays
89  - Combine multiple strategies into a single, single-pass strategy
90  - Get PH5P working with the latest versions of DOM, which have much more
91    stringent error checking procedures. Maybe convert straight to tokens.
92  - Get rid of set_include_path(). Save this for another major release.
94 Neat feature related
95  ! Factor demo.php into a set of Printer classes, and then create a stub
96    file for users here (inside the actual HTML Purifier library)
97  ! Support exporting configuration, so users can easily tweak settings
98    in the demo, and then copy-paste into their own setup
99  - Advanced URI filtering schemes (see docs/proposal-new-directives.txt)
100  - Allow scoped="scoped" attribute in <style> tags; may be troublesome
101    because regular CSS has no way of uniquely identifying nodes, so we'd
102    have to generate IDs
103  - Explain how to use HTML Purifier in non-PHP languages / create
104    a simple command line stub (or complicated?)
105  - Fixes for Firefox's inability to handle COL alignment props (Bug 915)
106  - Automatically add non-breaking spaces to empty table cells when
107    empty-cells:show is applied to have compatibility with Internet Explorer
108  - Table of Contents generation (XHTML Compiler might be reusable). May also
109    be out-of-band information.
110  - Full set of color keywords. Also, a way to add onto them without
111    finalizing the configuration object.
112  - Write a var_export and memcached DefinitionCache - Denis
113  - Allow restriction of allowed class values
115 Maintenance related (slightly boring)
116  # CHMOD install script for PEAR installs
117  ! Factor out command line parser into its own class, and unit test it
118  ! Nested configuration namespaces
119  - Distinguish between default settings and explicitly set settings, so
120    configurations can be merged
121  - Time PHPT tests
123 ChildDef related (very boring)
124  - Abstract ChildDef_BlockQuote to work with all elements that only
125    allow blocks in them, required or optional
126  - Implement lenient <ruby> child validation
128 Wontfix
129  - Non-lossy smart alternate character encoding transformations (unless
130    patch provided)
131  - Pretty-printing HTML: users can use Tidy on the output on entire page
132  - Native content compression, whitespace stripping: use gzip if this is
133    really important
135     vim: et sw=4 sts=4