first import

2015-04-08 11:40:19 +02:00
commit 1bc61b12ad
8435 changed files with 1582817 additions and 0 deletions
@@ -0,0 +1,60 @@
+DraggableViews
+==============
+
+This module provides dragging entities and saving their order.
+
+Quick install:
+ 1) Activate Draggableviews module at admin/modules
+ 2) Navigate to view edit-page, click on the first link at the Format section and then choose style "table".
+ 3) Click Add button at the "Fields" section and choose field "Content:title", add and apply.
+ 4) Click Add button at the "Fields" section and choose field "Content:Draggable views (Draggable views)", add and apply.
+ 5) Click Add button at the "Sort criteria" section and choose field "Content:Draggable views weight", add and choose sort asc, then apply.
+ 6) Save the view and you're done.
+
+In the case of table standard drupal tabledrag.js javascript is used.
+
+We also support jQuery UI Sortable javascript. In order to use it please set display style HTML List.
+By default HTML list is displayed like grid. If you would like it to be displayed as list override
+CSS styles for example in following way:
+  .draggableviews-processed li.views-row { float: none; width: 100%; margin-left: 0; }
+
+One view/display to set order another to display
+================================================
+
+You can create one view to set the order and another view to display the order. Or even
+create one view with two separate displays. In a view that displays the order there
+should be no draggableviews field (that makes view sortable), then in the settings of
+the "draggableviews weight" sorting criteria there will be selectbox "Display sort as"
+where you can choose the source view of your weights. This is applicable when you use
+ Native handler.
+
+Permissions
+===========
+
+Please add "Access draggable views" permission to users who should be able to reorder views.
+
+Arguments handling
+==================
+
+Every time we save the order of a view, current set of arguments are saved with order.
+You can see this in draggableviews_structure table "args" column. By default when we display order we use all
+currently passed arguments to a view to "match" arguments in "args" column. This means that we can create
+a view with contextual filter or exposed filter criteria and save different orders for different sets of arguments.
+
+We can also completely ignore passed arguments using "Do not use any arguments (use empty arguments)" option
+in Arguments handling of Sort criteria Draggable views weight. Be aware that in this case empty arguments set
+will be used. So you can set order for a view when no arguments passed and then whatever arguments passed,
+empty set will be used.
+
+Prepare arguments with PHP code is an option when you would like to alter arguments before they passed to
+"matching" with "args" column. For us this means that we can create for example several exposed filters,
+but pass values of only one of values of exposed filters instead of all of them (like we create two exposed
+filters: author and node type, but take into account for ordering only node type).
+Please be aware that in PHP code arguments are passed as $arguments variable and you should return array.
+Contextual filters are number keyed and exposed filters are name keyed.
+
+Contextual link "Order view"
+============================
+
+If there is view with sort order draggableviews weight and the order is set by another view we show "Order view"
+contextual link for opening a view that sets the order.