source: sipes/modules_contrib/auto_nodetitle/README.txt @ 6e81fb4

$Id: README.txt,v 1.7.2.4 2009/07/15 19:59:14 fago Exp $

Automatic Nodetitle Module
------------------------
by Wolfgang Ziegler, nuppla@zites.net


Description
-----------
This is a small and efficent module that allows hiding of the content title field in the form.
To prevent empty content title fields it sets the title to the content type name or to an
configurable string. If the token module is installled it's possible to use various content
data for the autogenerated title - e.g. use the text of a CCK field.

Advanced users can also provide some PHP code, that is used for automatically generating an
appropriate title.

Installation 
------------
 * (optional) Download and install the token module.
 * Copy the module's directory to your modules directory and activate the module.
 * For each content type you want to have an automatic title, click on the
   "edit" link for it on 'admin/content/types'
 * At the top of the content type edit form, there is a "Automatic title
   generation" box allowing you to configure the details for the current content
   type.
 
 
 
 
 Advanced Use: PHP Code
------------------------
 You can access $node from your php code. Look at this simple example, which just adds the node's
 author as title:
 
<?php return "Author: $node->name"; ?>

 
 
 Advanced Use: Combining tokens and PHP
 ---------------------------------------
 
 You can combine php evalution with the token module, because tokens are replaced first.
 However be aware to don't use this with any textual values provided by users as this would
 open a security hole. If you are in doubt, don't combine tokens with php evaluation.
 
 Here is an example:
 
<?php
  $token = '[field_testnumber]';
  if (empty($token)) {
    return '[type]';
  }
  else {
    return $token;
  } 
?>

 So if the text of the CCK number [field_testnumber] isn't empty it will be used as title.
 Otherwise the node type will be used.


 
 
 Updating nodetitles from existing nodes
 ---------------------------------------
 If you set the nodetitle to be auto generated for some content type, existing nodes
 are not affected. You can update existing nodes by going to 'admin/content/node',
 then filter for your content type, mark some nodes and choose the "Update option" 
 "Update automatic nodetitles".