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