====== Classified ======
This is a rebuild of the original http://drupal.org/project/ed_classified module for Drupal 6 (and later), dropping any 4.x/5.x remnants.
Download or clone from http://bit.ly/cIBtcN
===== Battle plan for multiple node types =====
Node types
As per #195494, the goal is to support multiple node types.
- The included node type must remain for ease of use
- Other existing node types must be supported
- Since extra fields are per-node-type, this implies replacing the extra
fields by a proper field
- Ad lists can therefore no longer be built by node type.
- Take advantage of the change to replace custom lists by default Views
- Enabled node types can either be defined by module settings, or (better ?)
automatically be identified by the presence of an instance of the
expiration field
Extra fields to Field
The module defines two form extra fields, expires_fs
on forms
and expires
for display
- Kill both extra fields
- Add a new Field replacing both, this means:
- Done. Field is now available on Field UI only for node entities.
Adding field info/CRUD hooks
- Hooks implemented. Actual logic to be done. Adding a new widget to replace the form logic for
expires_fs
- Hooks implemented. Actual logic to be done. Adding a new formatter to replace the node view logic for
expires
Custom lists to Views
The module has inner knowledge of the specifics of the expiration extra
fields.
Lists are built either using custom built lists including it, or using
the new custom view mode introduced in 7.3. With multiple node types, this
is no longer doable so we replace these lists by taxonomy-filtered views.
With the extra field gone, its Views field handler no longer works.
- Replace the expiration field handler
- Replace the home page list with a view. Keep the various counters.
- Replace the per-term list with a view. Keep the various counters,
sub-category links, and breadcrumbs generation. This is likely to
involve attached views and/or new specific handlers.
- Replace the per-user profile list with a view. Handle the empty case.
- Replace the per-user rendered and raw token with two displays of a view.
- Replace the per-user link token, possibly still by manual code.
Configuration
- Simplify configuration: reduce the number of variables by grouping lifetimes in a single variable
- Remove maxlength logic: use maxlength module instead of maintaining it here.
Custom logic
Most of the module complexity lies in the expiration handling: automatic
expires generation and update. This needs to be adapted for the additional
complexity of a field over an extra field. Existing node form hooks and
handlers must be replaced by field hooks since we no longer know which forms
to intercept.
i18n
A number of users have expressed frustration at the lack of i18n support
in the module. Switching the extra fields to a field and the custom lists
to Views will help with this. New code should be i18n-compatible, so that
later changes can bring full i18n compliance
Testing
The code currently has 100% S0 test coverage. This should not go down, but
increase towards 100% C0.
- Rewrite tests to match the new code structures
- Add tests for each new function/method introduced
Drupal 8
Any significant work should take into account the directions taken by D8.
The move from an extra field to a normal field is in the right direction. Other significant
changes regard code placement outside the module file and the use of
autoloaded namespaced classes, one per file.
- Strip all non-hook code from the module file and move it to class
methods
- Extract all logic from hook implementations to class (static) methods, leaving only the "glue" bits in the hook implementation, to ease unit testing.
- Action code externalized in so doing should be considered for being made
usable at the admin level by exposing it as a core action, typically for
the user or node entities
- Done: converted to
classloader
. Consider using xautoload
or classloader
to apply PSR-0, or declare classes the D7 way, manually in the info file.
===== Services provided by the module =====
- 1 specific vocabulary: `classified_categories`, supplied with 2 sample terms (Wanted and For Sale)
- 1 specific node type: `classified` equipped with
- a taxonomy_term_reference field pointing to the module vocabulary
- a body field
- 3 blocks:
- recent ads (public)
- popular ads (public)
- ad stars (admin)
- 1 Context Condition plugin
- 1 CTools "content type" plugin to expose the `expires` pseudo field
- 2 permissions
- `administer classified ads`
- `reset classified ads expiration`
- 2 extra fields
- `expires_fs`: a form extra field allowing selection of an expiration type and optionally a manual expiration date for ad nodes
- `expires`: a display extra field formatting the expiration date for ad nodes
- 1 notifications submodule: send notifications
- at half-life
- before|on expiration
- before|on purge
- 3 drush commands
- `classified-purge` to purge expired nodes
- `classified-expire` to expire nodes
- `classified-notify` to send notifications
- 1 custom view mode for `node`
- 2 menu loaders
- notify kind
- taxonomy term, only accepting terms from the module vocabulary
- 3 user tokens
- `[classified-ads]` themed list of user ads
- `[classified-ads-plain]` raw list of user ads
- `[classified-ads-url]` url of a user's ads list
- 2 theme items
- `classified_admin_lifetimes`
- `classified_expires` for the `expires` extra field
- 1 field formatter for term_reference fields, linking to the per-term ad list instead of the default term page, with an optional link title
- node form logic
- handle the extra field
- provide fieldset-level access control for expiration type
- maxlength JS
- auto-hiding manual expiration date when irrelevant
- node access logic
- requirements logic
- detect incompatible older version
- detect missing Statistics module
- detect misconfigured Statistics module
- detect non-tree hierarchy in the module vocabulary
- taxonomy change logic for terms and vocabularies
- URL outbound rewriting logic to redirect term links to ad lists when applicable
- Views integration logic
- expose virtual fields:
- `expires`: field, sort, filter
- `purge`: field
- 1 field handler for `purge`
- default views logic scanning the `views/` folder, but no views provided
- configuration variables
- `classified-max-length` for the maxlength JS
- `classified-list-body` List display format
- `classified-edit-modr8` (obsolete) modr8 integration
- `classified-lifetime-default` default lifetime
- `classified-lifetime-