Index: help/views.help.ini =================================================================== RCS file: /cvs/drupal-contrib/contributions/modules/views/help/views.help.ini,v retrieving revision 1.17.2.3 diff -u -p -r1.17.2.3 views.help.ini --- help/views.help.ini 30 Nov 2009 19:37:02 -0000 1.17.2.3 +++ help/views.help.ini 12 Feb 2011 00:23:34 -0000 @@ -4,16 +4,20 @@ line break = TRUE [about] title = "What is Views?" -weight = -40 +weight = -50 [getting-started] title = "Getting started" -weight = -45 +weight = -40 + +[new] +title = "What's new in Views 2" +weight = -30 [example-users-by-role] title = "Create a page to list users by role" parent = getting-started -weight = -10 +weight = -20 [example-recent-stories] title = "Create a block of recent stories" @@ -30,12 +34,28 @@ title = "Create a block of author's rece parent = getting-started weight = 40 -[view-type] -title = "View types" +[view-add] +title = "Add a View" +weight = -10 + +[view-settings] +title = "View settings" +weight = 0 + +[basic-settings] +title = "Basic settings" +weight = 10 + +[advanced-settings] +title= "Advanced settings" +weight = 20 + +[demo-video] +title= "Demonstration Video" [display] title = "Displays" -weight = -30 +weight = -10 [display-default] title = "Default display" @@ -60,119 +80,159 @@ parent = display title = "Feed display" parent = display -[argument] -title = "Arguments" -parent = about - -[field] -title = "Fields" -parent = about - -[sort] -title = "Sorts" -parent = about - -[filter] -title = "Filters" -parent = about - -[relationship] -title = "Relationships" -parent = about +[style-settings] +title = "Style settings" +weight = 30 [style] -title = "Output styles (View styles)" +title = "Style" +parent = style-settings weight = -20 -[style-row] -title = "View row styles" +[style-grid] +title = "Grid (output style)" parent = style -weight = 10 +weight = 0 [style-list] -title = "List output style" +title = "HTML List (output style)" parent = style - -[style-unformatted] -title = "Unformatted output style" -parent = style -weight = -6 +weight = 10 [style-table] -title = "Table output style" +title = "Table (output style)" parent = style -weight = -5 +weight = 20 -[style-grid] -title = "Grid output style" +[style-unformatted] +title = "Unformatted (output style)" parent = style -weight = -5 +weight = 30 [style-rss] title = "RSS output style" parent = style -weight = -5 +weight = 50 + +[style-row] +title = "Row styles" +weight = -10 +parent = style-settings [style-fields] -title = "Fields row style" +title = "Fields" parent = style-row +weight = -10 [style-node] -title = "Node row style" +title = "Node" parent = style-row +weight = 0 [style-node-rss] title = "Node RSS item row style" parent = style-row +weight = 10 [style-comment-rss] title = "Comment RSS item row style" parent = style-row +weight = 20 -[style-summary-unformatted] -title = "Unformatted summary style" -parent = "style" -weight = 10 - -[style-summary] -title = "List summary style" -parent = "style" -weight = 10 - -[menu] -title = "Menu options (page display)" +[performance] +title = "Performance" -[path] -title = "Path options (page display)" +[performance-views-vs-displays] +title = "Multiple Views vs Multiple Displays" +parent = performance [analyze-theme] title = "Theme information" +parent = style-settings +weight = 30 [using-theme] title = "Using Views templates" parent = analyze-theme +weight = 40 [theme-css] title = "Using CSS with Views" -parent = analyze-theme +parent = style-settings +weight = 20 + +[menu] +title = "Menu options (page display)" +parent = display-page + +[path] +title = "Path options (page display)" +parent = display-page + +[exposed-form] +title = "Exposed Form" +weight = 45 + +[header] +title = "Header" +weight = 50 + +[footer] +title = "Footer" +weight = 60 + +[empty-text] +title = "Empty Text" +weight = 70 + +[field] +title = "Fields" +weight = 80 + +[relationship] +title = "Relationships" +weight = 90 + +[argument] +title = "Arguments" +weight = 100 + +[style-summary-unformatted] +title = "Summary Style: Unformatted (output style)" +parent = argument + +[style-summary] +title = "Summary Style: List (output style)" +parent = argument + +[sort] +title = "Sort criteria" +weight = 110 + +[filter] +title = "Filters" +weight = 120 [overrides] title = "What are overrides?" +parent = display [embed] title = "Embedding a view into other parts of your site" - -[new] -title = "What's new in Views 2" -weight = -42 +weight = 140 [updating] title = "Updating your views from Views 1 to Views 2" +weight = 150 + +[updating-view3] +title = "Updating your views from Views 2 to Views 3" +weight = 160 ; API related [api] title = "Views' API" -weight = 100 +weight = 170 [api-tables] title = "Describing tables to Views" @@ -202,3 +262,7 @@ parent = api title = "Integrating the Node Example module" parent = api weight = 100 + +[example-view-limit-with-view] +title = "Tutorial: How to exclude nodes from a view by another view" +parent = api Index: help/example-view-limit-with-view.html =================================================================== RCS file: help/example-view-limit-with-view.html diff -N help/example-view-limit-with-view.html --- /dev/null 1 Jan 1970 00:00:00 -0000 +++ help/example-view-limit-with-view.html 12 Feb 2011 00:23:34 -0000 @@ -0,0 +1,116 @@ + +

In this example you will create two views. The first view will pull information, the second will be used to filter out the first. This will demonstrate using php and arguments together as well as cloning to extend the functionality of Views.

+ +

Before working through this example, create several entries of the page content type (Devel module is good at this if you don't want to do it manually.) Of those, select a few at random and edit them. Under Publishing options, check "Sticky at top of lists" and save.

+ +

Creating the View

+

The first step is to create a view that will pull node ids(nids) of the nodes that we want to exclude. Go to Administer -> Site Building -> Views -> Add, or add new view, enter the following properties, and click Next:

+ +
+
View name
+
exclude_list
+
View description
+
List of node ids that we want to exclude.
+
View tag
+
page
+
View type
+
Node
+
+ +

Generating a list of page entries

+

We will get views to give us the nids of the pages that have been checked "Sticky at top of lists"

+ +
    +
  1. Locate the Fields area. In this case we need Node: Title. Click the + icon to add a field.
    2. +
  2. Scroll down to Defaults: Add fields, below the settings table. A large selection of fields will be available.
    3. +
  3. In the Groups drop-down menu, select Node. This will limit the list to only the default fields exposed by Node module.
    4. +
  4. Scroll down the list, select the Node: Nid field, and click Add.
    5. +
  5. You will now be presented with settings for the Node: Nid field. Delete the label from the Label field, so that each individual node title is not prefixed with the word "Nid."
    6. +
  6. When finished, click Update. If you scroll down to the Live Preview section, you should now see a list of several node ids (if not, click the Preview button); however, both page entries and other node types will be in the list. Let's fix that.
    7. +
  7. Locate the Filters area. We can use a filter to showing node titles only from page entries and not every type of node. Click the + icon to add a filter.
    8. +
  8. As before, scroll down to the Defaults: Add filters section, select Node from the Groups select box to limit the list of options to only those exposed by Node module.
    9. +
  9. Scroll down and select the Node: Type field and click Add. In the settings page that appears, leave Operator as Is one of and select Page under Node type. Click Update when finished.
    10. +
  10. Now, by scrolling down to Live preview, you'll see that the list only shows page entries.
    11. +
  11. Click Save to save the view to the database
    12. +
+ + +

Cloning the view

+

We will get views to create a list of the nids and titles of the pages that are not sticky by using our first view (exclude_list) as a base for the view that will pull the final result. It may seem counterintuitive to begin the process by targeting the entries we are trying to exclude. Keep in mind that the exclude list does not depend on the view that will be filtered. Instead, the view that will be filtered depends on the exclude_list. +

+ +

From the exclude_list edit page or the view list page you can click on the clone link or go to clone the view, enter the following properties, and click Next:

+ +
+
View name
+
include_list
+
View description
+
List of node ids and titles dynamically filtered by the exclude_list view.
+
View tag
+
page
+
View type
+
Node
+
Expanding the scope of the view +

The exclude_list view does a great job of filtering out only the nodes that we do not want. We are going to expand the view so it lists the entire set of nids and titles.

+ +
    +
  1. Locate the Fields area. Click the + icon to add a field.
    2. +
  2. Scroll down to Defaults: Add fields, below the settings table.
    3. +
  3. In the Groups drop-down menu, select Node.
    4. +
  4. Scroll down the list, select the Node: Title field, and click Add.
    5. +
  5. You will now be presented with settings for the Node: Title field. Delete the label from the Label field, so that each individual node title is not prefixed with the word "Title." Additionally, check the Link this field to its node box so that visitors who see an interesting title can click directly on it to view the node's page. Click Update
    6. +
  6. Locate the Filters area. Click the ↑ ↑ icon to rearrange the filter.
    7. +
  7. Scroll down to Defaults: Rearrange filters click the gear icon on the on the same line as Node: Sticky Yes to remove the filter
    8. +
  8. Click Update when finished.
    9. +
  9. Now, by scrolling down to Live preview, you'll see the list of all the page entries, including those we are trying to filter.
    10. +
  10. Click save to save the view to the database
    11. +
+ + +

Adding context with arguments

+

Arguments allow us to interactively filter our views, however views cannot forsee every situation that a user may have to filter. For that views allows us to use php to further modify the action of the view.

+ +

+Before continuing, we are going to discuss the mechanism which we will use to embed one view into another view. +The views api provides developers various methods of influencening the funcitonality of view. We will use one of the functions provided by the api, to get an array of of the results. We will parse this array to format it in a manner that allow it to be accepted as an argument. +

+//Declare a variable that calls the views_get_views_result function. This variable now contains the result of the view.
+$results = views_get_view_result('exclude_list', $display_id = NULL);
+  //Create a condition to ensure we have results and to provide a default argument if we do not. First tell php what to do with our variable if it has results 
+  if(!empty($results)){
+    //Create an empty array that will hold our nids
+    $willbestring= array();
+    //Iterate (go over) the results variable and fill in the array
+    foreach($results as $key => $value) {
+    $string[] = $value->nid;
+    }
+    //Use php'simplode function to create a string that contains the nids seperated by a plus
+    $string = implode("+", $willbestring);
+  }
+  //If there are no results declare the values '5+6'
+  else{
+    $string = "5+6"; //You can put any values or "" to return an empty string
+  }
+
+return $string;
+
+ +

+ +

Let's walk through adding and configuring an argument to our view so that we can use our first view to filter our second view.

+ +
    +
  1. In the third column, locate the Arguments area. Click the + icon to add an argument.
    2. +
  2. Because we are basing the view around nodes, this time under Groups select Node. Check Node: Nid and click Add.
    3. +
  3. The Defaults: Configure Argument User: Uid settings page has a lot going on, but only a few things that need our attention.
    4. +
  4. Under Action to take if argument is not present, there are a variety of options, ranging from displaying a 404 or a 403 page to simply displaying all values in the view. In our case, the argument handler (the code that allows views to understand the argument) doesn't exist. Select Provide default argument.
    5. +
  5. Assuming JavaScript is enabled in your browser, you should now get another selection for Default argument type. Select PHP Code.
    6. +
  6. A new text area with the title PHP argument codeshould appear
    7. +
  7. Enter the code from the paragraph into the text area
    8. +
  8. Validator options provide a useful way to control what kind of arguments your view will accept. Select Node as the Validator. By default, changing this setting will check the incoming argument and ensure it's a valid node ID; if not, the view will be hidden from the page.
    9. +
  9. Select "Node IDs separated by , or +" This will instruct the validator to check that the arguments are numeric and seperated by a + or ,. If they aren't it will hide the view.
    10. +
  10. Once you have changed the argument's title, default argument, and validator options, click Update to save your changes.
    11. +
  11. If all went well the view should now filter from exclude_list view
    12. +