Index: help/example-recent-stories.html =================================================================== RCS file: help/example-recent-stories.html diff -N help/example-recent-stories.html --- /dev/null 1 Jan 1970 00:00:00 -0000 +++ help/example-recent-stories.html 30 Jul 2008 18:57:44 -0000 @@ -0,0 +1,58 @@ + +In this example you will create a list of nodes of the content type "story", to be shown in a block. Through this step-by-step process, you will become familiar with some basic steps in creating a view, and familiarize yourself with the Views User Interface. + +
    +

  1. Creating a new view

    +

    Go to add new view. Give your new view the name 'recent_stories', description 'Recent Stories', tag 'story', type 'Node' and click Next.

    2. +

  2. About the interface

    +

    You have been brought to Views User Interface. As you start, you are editing the "Default" options for the view. In the 1st column on the left you can see the drop-down menu offers 'block', for example, to select settings specific only to block views. In the remaining columns, you will be able to add or change options by clicking on links or icons. These options will then appear below this main area. Most likely, you will need to scroll a bit to see the options appear.

    3. +

  3. Selecting the fields to display

    +
      +
    1. In 3rd column locate the Fields options. Click the + icon to add fields.
      2. +
    2. Scroll down to Defaults: Add fields. In the Groups drop-down menu select 'Node', then check the following two fields: Node: Post date, Node: Title. Then click Add.
      3. +
    3. You will be taken through the fields you added one at a time. Make the changes specified below. +
        +
      • For the Post date field: Delete the 'Post date' label. Change the Date format to Custom, and the Custom date format to 'F j, Y, g:i a' (do not type the single quotes; for the meaning of these letter codes, click on the PHP docs link under that box to arrive at the explanation). Click Update.
        • +
      • For the Title field: Delete the 'Title' label. Select Link this field to its node. Click Update.
        • +
      +
      4. +
    4. Scroll back up to Fields and click the ↑↓ icon to rearrange fields.
      5. +
    5. Drag the four-sided arrow next to Node: Title so that it appears above Node: Post date. Click Update to save the new field order.
      6. +
    +
    4. +

  4. Filtering to story nodes only

    +
      +
    1. Click the + icon next to Filters.
      2. +
    2. In the Groups drop-down menu select 'Node', then check the Node: Published and Node: Type filters, and click Add.
      3. +
    3. Select the Published checkbox. Click Update
      4. +
    4. Select Is one of and check Story in the Node Type field. Click Update.
      5. +
    +
    5. +

  5. Sorting to show most recent first

    +
      +
    1. Scroll up to Sort criteria and click the + icon.
      2. +
    2. In the Groups drop-down menu below, select 'Node', then check Node: Post date, and click Add. Alternatively, you may instead check Node: Last comment time, or Node: Updated/commented date, or Node: Updated date.
      3. +
    3. Select Descending Sort order. Click Update.
      4. +
    +
    6. +

  6. Refining the basic settings

    + +
    7. +

  7. Adding a block display for custom options

    +
      +
    1. In the dropdown on the left, ensure that Block is selected, and click Add Display.
      2. +
    2. Under Block settings, click the None link next to the Admin setting. Change Block: Block admin description to 'Recent Stories'.
      3. +
    +
    8. +

  8. Saving the view

    +

    Click Save to save your work.

    9. +

  9. Instructing Drupal to show the block

    +

    Finally, you should tell Drupal to show this block. Configure your block by going to admin/build/block. Locate the block in the list: it is labeled Recent Stories. Place this block in a region and click Save. You may click Configure to set a different title, to determine which roles can view the block, and on which pages it appears; If you want your block on the front page only, enter '<front>'.

    10. +
Index: help/example-users-by-role.html =================================================================== RCS file: help/example-users-by-role.html diff -N help/example-users-by-role.html --- /dev/null 1 Jan 1970 00:00:00 -0000 +++ help/example-users-by-role.html 30 Jul 2008 18:57:44 -0000 @@ -0,0 +1,48 @@ + +In this example you will create a page view listing users on your site. Through this step-by-step process, you will become familiar with some basic steps in creating a view, and familiarize yourself with the Views User Interface. + +
    +

  1. Creating a new view

    +

    Go to add new view. Give your new view the name 'user_list', description 'A simple user listing.', tag 'users', type 'User' and click Next.

    2. +

  2. About the Interface

    +

    You have been brought to the Views User Interface. As you start, you are editing the "Default" options for the view. In the 1st column on the left you can see the drop-down menu offers 'block', for example, to select settings specific only to block views. In the remaining columns, you will be able to add or change options by clicking on links or icons. These options will then appear below this main area. Most likely, you will need to scroll to see the options appear. As you make changes, these options will appear in bold until you save your view.

    3. +

  3. Creating a page display; choosing a URL and creating a menu link

    +
      +
    1. In the 1st column, ensure that 'Page' is selected in the drop-down menu, and click Add Display.
      2. +
    2. Next we'll define the path for this page. A page must have a path, and we define it early so that Views doesn't warn us "Display Page uses path but path is undefined." Locate the Page settings in the 2nd column, and click the None link next to the Path setting. In the options editing area that appears below, set the path to 'user_list' (or something else if you prefer) and click Update.
      3. +
    3. Next to Menu setting, Click the No menu link. In the options which appear below, select Normal menu entry, and set the title to 'User list' and click Update.
      4. +
    4. Scroll up to Basic settings, in that same 2nd column, and click the No link next to Use pager. Below, in the options, select Full pager and click Update default display.
      5. +
    +
    4. +

  4. Selecting the fields to display

    +
      +
    1. In 3rd column locate the Fields options. Click the + icon to add fields.
      2. +
    2. Scroll down to Defaults: Add fields. In the Groups drop-down menu select 'User', then check the following fields: User: Created date, User: Delete link, User: Edit link, User: Last access, User: Name and User: Picture. Then click Add.
      3. +
    3. You will be taken through the fields you added one at a time. Click Update default display to go to each next field. Leave the default options on all fields except Delete link; change that field's label to 'Operations'.
      4. +
    4. Scroll back up to Fields and click the ↑↓ icon to rearrange fields. Down below, drag the Name field, by dragging its four-sided arrow, to the top. Drag the Delete link (Operations) field to the bottom, and the Edit link field just above it. Then click Update.
      5. +
    +
    5. +

  5. Seeing what we've done so far

    +

    At this point, you have done enough to create a valid view. If you scroll down, you will see a preview of your view. If it doesn't show already, click the Preview button; but generally this display updates automatically whenever you finish working in one of the mini forms.

    6. +

  6. Styling the view as a table; combining related fields into columns

    +
      +
    1. Under Basic settings, in the 1st column, click the Unformatted link next to the Style setting. In the options below, under Page: How should this view be styled, choose Table and click Update default display.
      2. +
    2. You will be taken to a Page: Style options form to edit the table settings. Locate our Edit link field in this mini form, and notice the Column drop-down. Change this drop-down to show Operations. In the Separator column next to the Operations field, type ' | ' (note the spaces around the | symbol). Check all of the Sortable checkboxes, and set Default sort to Name. When finished, click Update default display.
      3. +
    +
    7. +

  7. Filtering the user list to exclude unwanted entries

    +
      +
    1. Click the + icon next to Filters.
      2. +
    2. In the Groups drop-down menu select 'User', then check the User: Name filter, and click Add.
      3. +
    3. Select Is not one of and enter 'Anonymous' in the Usernames box. Click Update default display.
      4. +
    +
    8. +

  8. Adding an argument to list users by role dynamically

    +
      +
    1. Scroll up to Arguments, and click its + icon.
      2. +
    2. Check the User: Roles argument, and click Add. Set the title to '%1' (don't type the quotes), and under Action to take if argument is not present select Summary, sorted ascending. Leave the other settings as they are. Click Update default display, and click Update through the prompts that follow to accept their default values.
      3. +
    +
    9. +

  9. Saving the view

    +

    Finally, click the Save button to save your work. At the very top, click View "Page" to go to your new view!

    10. +
Index: help/getting-started.html =================================================================== RCS file: /cvs/drupal-contrib/contributions/modules/views/help/getting-started.html,v retrieving revision 1.4 diff -u -F^[^a-z]*function -r1.4 getting-started.html --- help/getting-started.html 2 Jul 2008 02:13:42 -0000 1.4 +++ help/getting-started.html 30 Jul 2008 18:57:44 -0000 @@ -3,28 +3,3 @@ It helps to have something particular in mind that you want to accomplish when using Views. Here are a couple of ideas and a brief sketch of how to accomplish what you want. -

Create a page to list users by role

-
    -
  1. Go to add new view.
    2. -
  2. Give it the name 'user_list', description 'A simple user listing.', tag 'users', type 'User' and click Next.
    3. -
  3. On the left, ensure that 'Page' is selected, and click Add Display.
    4. -
  4. Next to Fields click the + icon to add fields.
    5. -
  5. In the Groups section below, select 'User', then check the following user fields: Created date, Delete link, Edit link, Last access, Name and Picture. Then click Add.
    6. -
  6. You will be taken through the fields you added one at a time. Click Update default display to go to the next field. Leave the default options on all fields except Delete link; change that field's label to 'Operations'.
    7. -
  7. Under Page settings, click the None link next to the Path setting. Set the path to 'user_list' (or something else if you prefer) and click Update.
    8. -
  8. Click the No menu link under the Menu setting. Select Normal menu and set the title to "User list" and click Update.
    9. -
  9. At this point, you have done enough to create a valid view. If you scroll down, you will see a preview of your view. At any time you can click the Preview button, but whenever you finish one of the mini forms, the preview will update automatically, so you don't need to, generally.
    10. -
  10. Next to Fields, click the rearrange icon, which is to the right of the + icon. Down below, drag the Name field to the top, the Delete link (Operations) field to the bottom, and the Edit link field just above it. Then click Update.
    11. -
  11. Under the Basic settings, click the Unformatted link next to the Style setting. Change this to 'Table' below, and click Update default display.
    12. -
  12. You will be taken to the table settings form. Next to Edit link change the column to Operations. Next to Operations set the Separator to ' | ' (note the spaces around the | symbol). Check all of the Sortable checkboxes, and set Default sort to 'Name'. When finished, click Update default display.
    13. -
  13. Click the + icon next to Filters, select User under Groups below, choose the User: Name filter, and click Add.
    14. -
  14. Select Is not one of and enter 'Anonymous' in the Usernames field. Click Update default display.
    15. -
  15. Back under Basic settings, click the No link next to Use pager. Select Full pager and click Update default display.
    16. -
  16. Next to Arguments, click + icon, choose the User: Roles argument, and click Add. Set the title to "%1", the "Action to take if argument is not present" to "Summary, sorted ascending". Leave the other settings as they are. Click Update default display, and click Update through the prompts that follow to accept their default values.
    17. -
  17. Finally, click the Save button to save your work.
    18. -
  18. At the very top, click View "Page" to go to your new view!
    19. -
-

Create a block to list recent story nodes

-
    -
  1. TODO
    2. -
Index: help/views.help.ini =================================================================== RCS file: /cvs/drupal-contrib/contributions/modules/views/help/views.help.ini,v retrieving revision 1.13 diff -u -F^[^a-z]*function -r1.13 views.help.ini --- help/views.help.ini 26 Jun 2008 16:41:01 -0000 1.13 +++ help/views.help.ini 30 Jul 2008 18:57:44 -0000 @@ -10,6 +10,15 @@ title = "Getting started" weight = -45 +[example-users-by-role] +title = "Create a page to list users by role" +parent = getting-started +weight = -10 + +[example-recent-stories] +title = "Create a block of recent stories" +parent = getting-started + [view-type] title = "View types"