home | career | drupal | java | mac | mysql | perl | php | scala | uml | unix

Drupal example source code file (README.txt)

This example Drupal source code file (README.txt) is included in the DevDaily.com "Drupal Source Code Warehouse" project. The intent of this project is to help you "Learn Drupal by Example".

PHP - Drupal tags/keywords

default, format, if, is, role, selection, settings, the, to, user, when, will, you, your

The README.txt Drupal example source code

Better formats is a module to add more flexibility to Drupal's core input format system.

    * Set the default format per role.
    * Set the default format per content type.
    * Control allowed formats per content type.
    * Hide format tips.
    * Hide format selection, forcing the default to be used.
    * Expand the selection fieldset by default.
    * Disable the expand/collapse of the selection fieldset.
    * Set selection fieldset title.
    * Set default formats for nodes, comments, and blocks separately.
    * Works with CCK textareas.
    * Panels comment support.
    * I18n module support.
    * and more.



1. Copy the module folder to your server.
2. Enable the module via the modules page.


Simple 4-step usage:

1. Go to user permissions (/admin/user/permissions) and set your permissions.
2. Navigate to Site Configuration > Input formats (/admin/settings/filters)
3. There you will find 2 tabs where you can change your settings.
    Defaults (/admin/settings/filters/defauts)
    Settings (/admin/settings/filters/settings)
4. If you enable the "Control formats per node type" option. Go to your content
   type admin page to set those settings (example /admin/content/node-type/page).
   The settings are under the Input format settings fieldset.



When setting default formats ensure that you arranged the roles correctly
placing roles in their order of precedence. This is used to determine what
default a user will get when they have more than 1 role.

All logged in users are automatically assigned the authenticated user role
so this role must be below all other roles that you want to set a default for or
they will get the authenticated user role default instead.

Let's say you have the 2 roles that come with Drupal and have added an
'admin' role. You would most likely want to arrange the roles in this order:

  authenticated user
  anonymous user


Extended usage and notes:

* The default format will only be set on NEW nodes and comments. The format
  selected when the form is submitted is used for future editing purposes.

* The module is designed to always fall back to default settings when needed.
  This means that when you enable the module before you change any settings,
  it will use your current Drupal settings. Also when you enable conrol per node
  type it will use your global settings until you save the content type with new

* The permissions "collapse format fieldset by default" and
  "collapsible format selection" will only work if "Show format selection" is
  also given. This is because those 2 perms only have an effect when there is
  a format selection.

* The permission "collapse format fieldset by default" will only work if
  "collapsible format selection" is also given. This is because the
  fieldset can only be collapsed by default if it is collapsible.

* If you dis-allow a format that is already being used by content, the module
  will do its best to set the correct format. The precidence of the formats are:
  1. Existing format selected when last saved
  2. Content type default format
  3. Global default format
  4. First allowed format
  5. Drupal core site default format

* User 1 is treated the same as all other users when it comes to a default
  format. If user 1 has not been assigned any roles then it will be assigned
  the authenticated user role's default format. If you want user 1 to have the
  default of another role assign that role to user 1.

* Ensure you read the important notes in the previous section marked important.
  It explains how you must order your roles to effectively get your defaults.

Other Drupal examples (source code examples)

Here is a short list of links related to this Drupal README.txt source code file:

new blog posts

"Drupal" is a registered trademark of Dries Buytaert.

my drupal tutorials and examples  

Copyright 1998-2016 Alvin Alexander, alvinalexander.com
All Rights Reserved.

Beginning in 2016, a portion of the proceeds from pages under the '/drupal-code-examples/' URI will be donated to charity.