Uploaded image for project: 'Moodle'
  1. Moodle
  2. MDL-64840

Create web service core_badges_get_badges

    XMLWordPrintable

Details

    • New Feature
    • Status: Open
    • Minor
    • Resolution: Unresolved
    • 3.8
    • None
    • Badges, Web Services

    Description

      Search and return badges matching the parameters.

      Parameters:
      ----------list of ( 
          object {
              key string   //the badge column to search, expected keys (value format) are:
                                              "id" (int) matching badge id,
                                              "name" (string) badge name (Note: you can use % for searching but it may be considerably slower!),
                                              "expiredate" (int/timestamp) fixed date when the badge expires
                                              "expireperiod" (int/timestamp) relative time when the badge expire, after badge was issued
                                              "type" (int) 1 = site badge, 2 = course badge
                                              "courseid" (int) only if "type" = 2, course where the badge is related to
                                              "status" (int) 0 = inactive, 1 = active, 2 = inactive locked, 3 = active locked, 4 = archived
                                              "version" (string) badge version
              value string   //the value to search
          } 
      )Return value:
      -----------object {
      badges list of ( 
          object {
              id int   //ID of the badge
              name string //Name of the badge
              description string  //Description of the badge
              timecreated int  //Timestamp the badge was created
              timemodified int  //Timestamp the badge was last modified
              usercreated int  //ID of the user who created the badge
              usermodified int  //ID of the user who last modified the badge
              issuername string //Name of the issuer of the badge
              issuerurl string //Issuer URL, e.g. homepage
              issuercontact string Optional //Contact information of the issuer
              expiredate int Optional //Fixed date when the badge will expire (timestamp)
              expireperiod int Optional //Relative date when the badge will expire, after the badge was issued (timestamp)
              type int //Type of the badge (1 = site badge, 2 = course badge)
              courseid int Optional //The course where the badge relates to, only if type = 2
              message string //Text of the message the user receives when the badge is issued
              messagesubject string //Subject of the message the user receives when the badge is issued
              attachement int Optional //Whether to attach badge to message
              notification int Optional //Whether to notify issuer when badge is awarded
              status int //Status of the badge (0 = inactive, 1 = active, 2 = inactive locked, 3 = active locked, 4 = archived)
              nextcron int //Next cron
              version string Optional //Version of the badge
              language string //Language of the badge
              imageauthorname string  Optional //Name of the image author
              imageauthoremail string  Optional //Email of the image author
              imageauthorurl string  Optional //URL of the image author
              imagecaption string  Optional //Caption of the image
          } 
      )warnings  Optional //list of warnings
      list of ( 
            //warning
          object {
              item string  Optional //always set to 'key'
              itemid int  Optional //faulty key name
              warningcode string   //the warning code can be used by the client app to implement specific behaviour
              message string   //untranslated english message to explain the warning
          } 
      )} 

      Attachments

        Issue Links

          Activity

            People

              Unassigned Unassigned
              stefanerlachner Stefan Erlachner
              Carlos Escobedo Carlos Escobedo
              Yuliya Bozhko, Amaia Anabitarte, Carlos Escobedo, Laurent David, Mikel Martín Corrales, Sabina Abellan, Sara Arjona (@sarjona), Juan Leyva, David Woloszyn, Huong Nguyen, Jake Dallimore, Meirza, Michael Hawkins, Raquel Ortega, Safat Shahin, Stevani Andolo
              Votes:
              1 Vote for this issue
              Watchers:
              5 Start watching this issue

              Dates

                Created:
                Updated:

                Time Tracking

                  Estimated:
                  Original Estimate - Not Specified
                  Not Specified
                  Remaining:
                  Remaining Estimate - 0 minutes
                  0m
                  Logged:
                  Time Spent - 3 hours, 6 minutes
                  3h 6m