bachir/popsu-d7
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

contrib modules security updates

Browse Source
This commit is contained in:
Bachir Soussi Chiadmi
2016-10-13 12:10:40 +02:00
parent ffd758abc9
commit 747127f643
732 changed files with 67976 additions and 23207 deletions
Download Patch File Download Diff File Expand all files Collapse all files

380
sites/all/modules/feeds/feeds.api.php
View File

@@ -87,9 +87,9 @@ function hook_feeds_plugins() {
/**
* Invoked after a feed source has been parsed, before it will be processed.
*
* @param $source
* @param FeedsSource $source
* FeedsSource object that describes the source that has been imported.
* @param $result
* @param FeedsParserResult $result
* FeedsParserResult object that has been parsed from the source.
*/
function hook_feeds_after_parse(FeedsSource $source, FeedsParserResult $result) {
@@ -97,37 +97,110 @@ function hook_feeds_after_parse(FeedsSource $source, FeedsParserResult $result)
$result->title = 'Import number ' . my_module_import_id();
}
/**
* Invoked before a feed source import starts.
*
* @param FeedsSource $source
* FeedsSource object that describes the source that is going to be imported.
*/
function hook_feeds_before_import(FeedsSource $source) {
// See feeds_rules module's implementation for an example.
}
/**
* Invoked before a feed item is updated/created/replaced.
*
* This is called every time a feed item is processed no matter if the item gets
* updated or not.
*
* @param FeedsSource $source
* The source for the current feed.
* @param array $item
* All the current item from the feed.
* @param int|null $entity_id
* The id of the current item which is going to be updated. If this is a new
* item, then NULL is passed.
*/
function hook_feeds_before_update(FeedsSource $source, $item, $entity_id) {
if ($entity_id) {
$processor = $source->importer->processor;
db_update('foo_bar')
->fields(array('entity_type' => $processor->entityType(), 'entity_id' => $entity_id, 'last_seen' => REQUEST_TIME))
->condition('entity_type', $processor->entityType())
->condition('entity_id', $entity_id)
->execute();
}
}
/**
* Invoked before a feed item is saved.
*
* @param $source
* FeedsSource object that describes the source that is being imported.
* @param FeedsSource $source
* FeedsSource object that describes the source that is being imported.
* @param $entity
* The entity object.
* @param $item
* @param array $item
* The parser result for this entity.
* @param int|null $entity_id
* The id of the current item which is going to be updated. If this is a new
* item, then NULL is passed.
*/
function hook_feeds_presave(FeedsSource $source, $entity, $item) {
function hook_feeds_presave(FeedsSource $source, $entity, $item, $entity_id) {
if ($entity->feeds_item->entity_type == 'node') {
// Skip saving this entity.
$entity->feeds_item->skip = TRUE;
}
}
/**
* Invoked after a feed item has been saved.
*
* @param FeedsSource $source
* FeedsSource object that describes the source that is being imported.
* @param $entity
* The entity object that has just been saved.
* @param array $item
* The parser result for this entity.
* @param int|null $entity_id
* The id of the current item which is going to be updated. If this is a new
* item, then NULL is passed.
*/
function hook_feeds_after_save(FeedsSource $source, $entity, $item, $entity_id) {
// Use $entity->nid of the saved node.
// Although the $entity object is passed by reference, any changes made in
// this function will be ignored by the FeedsProcessor.
$config = $source->importer->getConfig();
if ($config['processor']['config']['purge_unseen_items'] && isset($entity->feeds_item)) {
$feeds_item = $entity->feeds_item;
$feeds_item->batch_id = feeds_delete_get_current_batch($feeds_item->feed_nid);
drupal_write_record('feeds_delete_item', $feeds_item);
}
}
/**
* Invoked after a feed source has been imported.
*
* @param $source
* @param FeedsSource $source
* FeedsSource object that describes the source that has been imported.
*/
function hook_feeds_after_import(FeedsSource $source) {
// See geotaxonomy module's implementation for an example.
// We can also check for an exception in this hook. The exception should not
// be thrown here, Feeds will handle it.
if (isset($source->exception)) {
watchdog('mymodule', 'An exception occurred during importing!', array(), WATCHDOG_ERROR);
mymodule_panic_reaction($source);
}
}
/**
* Invoked after a feed source has been cleared of its items.
*
* @param $source
* @param FeedsSource $source
* FeedsSource object that describes the source that has been cleared.
*/
function hook_feeds_after_clear(FeedsSource $source) {
@@ -154,7 +227,7 @@ function hook_feeds_after_clear(FeedsSource $source) {
function hook_feeds_parser_sources_alter(&$sources, $content_type) {
$sources['my_source'] = array(
'name' => t('Images in description element'),
'description' => t('Images occuring in the description element of a feed item.'),
'description' => t('Images occurring in the description element of a feed item.'),
'callback' => 'my_source_get_source',
);
}
@@ -175,118 +248,193 @@ function hook_feeds_parser_sources_alter(&$sources, $content_type) {
* @return
* The value to be extracted from the source.
*
* @see hook_feeds_parser_sources_alter().
* @see locale_feeds_get_source().
* @see hook_feeds_parser_sources_alter()
* @see locale_feeds_get_source()
*/
function my_source_get_source($source, FeedsParserResult $result, $key) {
function my_source_get_source(FeedsSource $source, FeedsParserResult $result, $key) {
$item = $result->currentItem();
return my_source_parse_images($item['description']);
}
/**
* Alter mapping targets for entities. Use this hook to add additional target
* options to the mapping form of Node processors.
* Adds mapping targets for processors.
*
* This hook allows additional target options to be added to the processors
* mapping form.
*
* If the key in $targets[] does not correspond to the actual key on the node
* object ($node->key), real_target MUST be specified. See mappers/link.inc
*
* For an example implementation, see mappers/content.inc
* For an example implementation, see mappers/text.inc
*
* @param &$targets
* Array containing the targets to be offered to the user. Add to this array
* to expose additional options. Remove from this array to suppress options.
* Remove with caution.
* @param $entity_type
* @param string $entity_type
* The entity type of the target, for instance a 'node' entity.
* @param $bundle_name
* The bundle name for which to alter targets.
* @param string $bundle
* The entity bundle to return targets for.
*
* @return array
* An array whose keys are the target name and whose values are arrays
* containing the following keys:
* - name: A human readable, translated label for the target.
* - description: (optional) A human readable, translated description for the
* target.
* - callback: The callback used to set the value on the target.
* - real_target: (optional) the name of the property on the entity that will
* be set by the callback. Specify this if the target name is not equal to
* the entity property name. This information will be used to clear the
* right target at the beginning of the mapping process.
* - optional_unique: (optional) A boolean that indicates whether or not the
* target can be used as an unique target. If you set this to TRUE, be sure
* to also specify "unique_callbacks".
* - unique_callbacks: (optional) An array of callbacks that are used to
* retrieve existing entity ids. Existing entities can be updated based on
* unique targets.
* - form_callbacks: (optional) An array of callbacks that are used to return
* a form with additional configuration for a target.
* - summary_callbacks: (optional) An array of callbacks that are used to
* display values of additional target configuration.
* - preprocess_callbacks: (optional) An array of callbacks that are used to
* set or change mapping options.
* - deprecated: (optional) A boolean that if TRUE, hides the target from the
* UI. Use this if you want to rename targets for consistency, but don't
* want to break importers that are using the old target name. If an
* importer uses this target it will show up as "DEPRECATED" in the UI.
*/
function hook_feeds_processor_targets_alter(&$targets, $entity_type, $bundle_name) {
function hook_feeds_processor_targets($entity_type, $bundle) {
$targets = array();
if ($entity_type == 'node') {
// Example 1: provide the minimal info for a target. Description is
// optional, but recommended.
// @see my_module_set_target()
$targets['my_node_field'] = array(
'name' => t('My custom node field'),
'description' => t('Description of what my custom node field does.'),
'callback' => 'my_module_set_target',
);
// Specify both summary_callback and form_callback to add a per mapping
// configuration form.
'summary_callback' => 'my_module_summary_callback',
'form_callback' => 'my_module_form_callback',
);
$targets['my_node_field2'] = array(
'name' => t('My Second custom node field'),
'description' => t('Description of what my second custom node field does.'),
// Example 2: specify "real_target" if the target name is different from
// the entity property name.
// Here the target is called "my_node_field2:uri", but the entity property
// is called "my_node_field2". This will ensure that the property
// "my_node_field2" is cleared out that the beginning of the mapping
// process.
$targets['my_node_field2:uri'] = array(
'name' => t('My third custom node field'),
'description' => t('A target that sets a property that does not have the same name as the target.'),
'callback' => 'my_module_set_target2',
'real_target' => 'my_node_field_two', // Specify real target field on node.
'real_target' => 'my_node_field2',
);
// Example 3: you can make your target selectable as an unique target by
// setting "optional_unique" to TRUE and specify one or more callbacks to
// retrieve existing entity id's.
// @see my_module_mapper_unique()
$targets['my_node_field3'] = array(
'name' => t('My third custom node field'),
'description' => t('A field that can be set as an unique target.'),
'callback' => 'my_module_set_target3',
'optional_unique' => TRUE,
'unique_callbacks' => array('my_module_mapper_unique'),
);
// Example 4: use the form and summary callbacks to add additional
// configuration options for your target. Use the form callbacks to provide
// a form to set the target configuration. Use the summary callbacks to
// display the target configuration.
// @see my_module_form_callback()
// @see my_module_summary_callback()
$targets['my_node_field4'] = array(
'name' => t('My fourth custom node field'),
'description' => t('A field with additional configuration.'),
'callback' => 'my_module_set_target4',
'form_callbacks' => array('my_module_form_callback'),
'summary_callbacks' => array('my_module_summary_callback'),
);
// Example 5: use preprocess callbacks to set or change mapping options.
// @see my_module_preprocess_callback()
$targets['my_node_field5'] = array(
'name' => t('My fifth custom node field'),
'description' => t('A field with additional configuration.'),
'callback' => 'my_module_set_target5',
'preprocess_callbacks' => array('my_module_preprocess_callback'),
);
// Example 6: when you want to remove or rename previously provided targets,
// you can set "deprecated" to TRUE for the old target name. This will make
// the target to be no longer selectable in the UI. If an importer uses this
// target it will show up as "DEPRECATED" in the UI.
// If you want that the target continues to work, you can still specify the
// callback.
$targets['deprecated_target'] = array(
'name' => t('A target that cannot be chosen in the UI.'),
'deprecated' => TRUE,
);
}
return $targets;
}
/**
* Alters the target array.
*
* This hook allows modifying the target array.
*
* @param array &$targets
* Array containing the targets to be offered to the user. Add to this array
* to expose additional options.
* @param string $entity_type
* The entity type of the target, for instance a 'node' entity.
* @param string $bundle
* The entity bundle to return targets for.
*
* @see hook_feeds_processor_targets()
*/
function hook_feeds_processor_targets_alter(array &$targets, $entity_type, $bundle) {
// Example: set an existing target as optional unique.
if ($entity_type == 'node' && $bundle == 'article') {
if (isset($targets['nid'])) {
$targets['nid']['unique_callbacks'][] = 'my_module_mapper_unique';
$targets['nid']['optional_unique'] = TRUE;
}
}
}
/**
* Example callback specified in hook_feeds_processor_targets_alter().
* Example callback specified in hook_feeds_processor_targets().
*
* @param $source
* @param FeedsSource $source
* Field mapper source settings.
* @param $entity
* @param object $entity
* An entity object, for instance a node object.
* @param $target
* @param string $target
* A string identifying the target on the node.
* @param $value
* @param array $values
* The value to populate the target with.
* @param $mapping
* @param array $mapping
* Associative array of the mapping settings from the per mapping
* configuration form.
*/
function my_module_set_target($source, $entity, $target, $value, $mapping) {
$entity->{$target}[$entity->language][0]['value'] = $value;
function my_module_set_target(FeedsSource $source, $entity, $target, array $values, array $mapping) {
$entity->{$target}[$entity->language][0]['value'] = reset($values);
if (isset($source->importer->processor->config['input_format'])) {
$entity->{$target}[$entity->language][0]['format'] =
$source->importer->processor->config['input_format'];
$entity->{$target}[$entity->language][0]['format'] = $source->importer->processor->config['input_format'];
}
}
/**
* Example of the summary_callback specified in
* hook_feeds_processor_targets_alter().
*
* @param $mapping
* Associative array of the mapping settings.
* @param $target
* Array of target settings, as defined by the processor or
* hook_feeds_processor_targets_alter().
* @param $form
* The whole mapping form.
* @param $form_state
* The form state of the mapping form.
*
* @return
* Returns, as a string that may contain HTML, the summary to display while
* the full form isn't visible.
* If the return value is empty, no summary and no option to view the form
* will be displayed.
*/
function my_module_summary_callback($mapping, $target, $form, $form_state) {
if (empty($mapping['my_setting'])) {
return t('My setting <strong>not</strong> active');
}
else {
return t('My setting <strong>active</strong>');
}
}
/**
* Example of the form_callback specified in
* hook_feeds_processor_targets_alter().
* Example of the form_callback specified in hook_feeds_processor_targets().
*
* The arguments are the same that my_module_summary_callback() gets.
*
* @see my_module_summary_callback()
*
* @return
* @return array
* The per mapping configuration form. Once the form is saved, $mapping will
* be populated with the form values.
*
* @see my_module_summary_callback()
*/
function my_module_form_callback($mapping, $target, $form, $form_state) {
function my_module_form_callback(array $mapping, $target, array $form, array $form_state) {
return array(
'my_setting' => array(
'#type' => 'checkbox',
@@ -296,6 +444,84 @@ function my_module_form_callback($mapping, $target, $form, $form_state) {
);
}
/**
* Example of the summary_callback specified in hook_feeds_processor_targets().
*
* @param array $mapping
* Associative array of the mapping settings.
* @param string $target
* Array of target settings, as defined by the processor or
* hook_feeds_processor_targets_alter().
* @param array $form
* The whole mapping form.
* @param array $form_state
* The form state of the mapping form.
*
* @return string
* Returns, as a string that may contain HTML, the summary to display while
* the full form isn't visible.
* If the return value is empty, no summary and no option to view the form
* will be displayed.
*/
function my_module_summary_callback(array $mapping, $target, array $form, array $form_state) {
if (empty($mapping['my_setting'])) {
return t('My setting <strong>not</strong> active');
}
else {
return t('My setting <strong>active</strong>');
}
}
/**
* Example of the unique_callbacks specified in hook_feeds_processor_targets().
*
* @param FeedsSource $source
* The Feed source.
* @param string $entity_type
* Entity type for the entity to be processed.
* @param string $bundle
* Bundle name for the entity to be processed.
* @param string $target
* A string identifying the unique target on the entity.
* @param array $values
* The unique values to be checked.
*
* @return int|null
* The existing entity id, or NULL if no existing entity is found.
*
* @see hook_feeds_processor_targets()
* @see FeedsProcessor::existingEntityId()
*/
function my_module_mapper_unique(FeedsSource $source, $entity_type, $bundle, $target, array $values) {
list($field_name, $column) = explode(':', $target . ':value');
// Example for if the target is a field.
$query = new EntityFieldQuery();
$result = $query
->entityCondition('entity_type', $entity_type)
->entityCondition('bundle', $bundle)
->fieldCondition($field_name, $column, $values)
->execute();
if (!empty($result[$entity_type])) {
return key($result[$entity_type]);
}
}
/**
* Example of the preprocess_callbacks specified in hook_feeds_processor_targets().
*
* @param array $target
* The full target definition.
* @param array &$mapping
* The mapping configuration.
*
* @see hook_feeds_processor_targets()
*/
function my_module_preprocess_callback(array $target, array &$mapping) {
// Add in default values.
$mapping += array('setting_value' => TRUE);
}
/**
* @}
*/